Skip to content
Back to search

streamlinear

A lightweight Linear MCP server for Claude Code that exposes one tool with action dispatch (search, get, update, comment, create, graphql, help) using ~500 tokens instead of the standard MCP's ~17,000.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/prime-radiant-inc/streamlinear with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/prime-radiant-inc/streamlinear'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/prime-radiant-inc--streamlinear/badge.svg)](/listings/prime-radiant-inc--streamlinear)

HTML

<a href="/listings/prime-radiant-inc--streamlinear"><img src="/api/listings/prime-radiant-inc--streamlinear/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Single Workspace

Add to your `.mcp.json`:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@primeradianthq/streamlinear@1.2.1"],
      "env": {
        "LINEAR_API_TOKEN": "lin_api_xxxxx"
      }
    }
  }
}

Multiple Workspaces

To use streamlinear with multiple Linear workspaces, create separate MCP entries and map each secret to `LINEAR_API_TOKEN`:

{
  "mcpServers": {
    "linear-personal": {
      "command": "npx",
      "args": ["-y", "@primeradianthq/streamlinear@1.2.1"],
      "env": {
        "LINEAR_API_TOKEN": "${LINEAR_PERSONAL_TOKEN}"
      },
      "envFrom": ["LINEAR_PERSONAL_TOKEN"]
    },
    "linear-work": {
      "command": "npx",
      "args": ["-y", "@primeradianthq/streamlinear@1.2.1"],
      "env": {
        "LINEAR_API_TOKEN": "${LINEAR_WORK_TOKEN}"
      },
      "envFrom": ["LINEAR_WORK_TOKEN"]
    }
  }
}

Installed Package

When installed as a dependency, the package provides two binaries:

npm install @primeradianthq/streamlinear@1.2.1
npx streamlinear-cli help
npx streamlinear

The MCP server requires `LINEAR_API_TOKEN` at runtime. Consumers such as Scribble may expose their own operator-facing variable and map it to `LINEAR_API_TOKEN` before starting streamlinear.

Post-Only Mode

Set `STREAMLINEAR_POST_ONLY=1` when confidentiality requires that the agent never read issue content. The server then refuses the read actions (`search`, `get`, and `graphql`) while `create`, `update`, `comment`, and `help` keep working. Internal lookups such as team names and workflow states still happen; they expose workspace metadata, not issue content.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "streamlinear",
  3. "version": "1.2.1",
  4. "description": "Streamlined Linear integration - one tool, seven actions, zero bloat",
  5. "author": {
  6. "name": "Prime Radiant"
  7. },
  8. "repository": "https://github.com/prime-radiant-inc/streamlinear",
  9. "mcpServers": {
  10. "linear": {
  11. "command": "node",
  12. "args": ["${CLAUDE_PLUGIN_ROOT}/mcp/dist/index.js"],
  13. "env": {
  14. "LINEAR_API_TOKEN": "${LINEAR_API_TOKEN}"
  15. }
  16. }
  17. }
  18. }
README.md · README · 125 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # streamlinear
  2. A lightweight Linear MCP for Claude Code. One tool, seven actions.
  3. ## Why?
  4. The standard Linear MCP uses ~17,000 tokens for tool definitions.
  5. streamlinear uses ~500 tokens.
  6. ## Design Philosophy
  7. Instead of 23 separate tools, streamlinear has **one tool with action dispatch**:
  8. ```json
  9. {"action": "search"}
  10. {"action": "get", "id": "ABC-123"}
  11. {"action": "update", "id": "ABC-123", "state": "Done"}
  12. {"action": "comment", "id": "ABC-123", "body": "Fixed!"}
  13. {"action": "create", "title": "New bug", "team": "ENG"}
  14. {"action": "graphql", "graphql": "query { viewer { name } }"}
  15. {"action": "help"}
  16. ```
  17. ## Actions
  18. | Action | Purpose |
  19. |--------|---------|
  20. | `search` | Find issues (smart defaults: your active issues) |
  21. | `get` | Issue details by ABC-123, URL, or UUID |
  22. | `update` | Change state, priority, assignee |
  23. | `comment` | Add comment to issue |
  24. | `create` | Create new issue |
  25. | `graphql` | Raw GraphQL for anything else |
  26. | `help` | Full documentation |
  27. ## Installation
  28. ### Single Workspace
  29. Add to your `.mcp.json`:
  30. ```json
  31. {
  32. "mcpServers": {
  33. "linear": {
  34. "command": "npx",
  35. "args": ["-y", "@primeradianthq/streamlinear@1.2.1"],
  36. "env": {
  37. "LINEAR_API_TOKEN": "lin_api_xxxxx"
  38. }
  39. }
  40. }
  41. }
  42. ```
  43. ### Multiple Workspaces
  44. To use streamlinear with multiple Linear workspaces, create separate MCP entries and map each secret to `LINEAR_API_TOKEN`:
  45. ```json
  46. {
  47. "mcpServers": {
  48. "linear-personal": {
  49. "command": "npx",
  50. "args": ["-y", "@primeradianthq/streamlinear@1.2.1"],
  51. "env": {
  52. "LINEAR_API_TOKEN": "${LINEAR_PERSONAL_TOKEN}"
  53. },
  54. "envFrom": ["LINEAR_PERSONAL_TOKEN"]
  55. },
  56. "linear-work": {
  57. "command": "npx",
  58. "args": ["-y", "@primeradianthq/streamlinear@1.2.1"],
  59. "env": {
  60. "LINEAR_API_TOKEN": "${LINEAR_WORK_TOKEN}"
  61. },
  62. "envFrom": ["LINEAR_WORK_TOKEN"]
  63. }
  64. }
  65. }
  66. ```
  67. ### Installed Package
  68. When installed as a dependency, the package provides two binaries:
  69. ```bash
  70. npm install @primeradianthq/streamlinear@1.2.1
  71. npx streamlinear-cli help
  72. npx streamlinear
  73. ```
  74. The MCP server requires `LINEAR_API_TOKEN` at runtime. Consumers such as Scribble may expose their own operator-facing variable and map it to `LINEAR_API_TOKEN` before starting streamlinear.
  75. ### Post-Only Mode
  76. Set `STREAMLINEAR_POST_ONLY=1` when confidentiality requires that the agent never read issue content. The server then refuses the read actions (`search`, `get`, and `graphql`) while `create`, `update`, `comment`, and `help` keep working. Internal lookups such as team names and workflow states still happen; they expose workspace metadata, not issue content.
  77. ## Smart Defaults
  78. - Teams and workflow states shown in tool description (fetched at startup)
  79. - `search` with no params → your assigned issues, not completed/canceled
  80. - IDs accept ABC-123, Linear URLs, or UUIDs
  81. - State names are fuzzy matched ("done" → "Done", "in prog" → "In Progress")
  82. - `assignee: "me"` uses the authenticated user
  83. - `@name` in create descriptions and comment bodies becomes a Linear profile link when it matches exactly one workspace user
  84. - Error messages show valid options when things fail
  85. ## The GraphQL Escape Valve
  86. For anything not covered by the main actions, use raw GraphQL:
  87. ```json
  88. {
  89. "action": "graphql",
  90. "graphql": "query { projects { nodes { id name } } }"
  91. }
  92. ```
  93. Use `{"action": "help"}` for common GraphQL patterns.
  94. ## License
  95. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.