Linear Issue MCP

An MCP (Model Context Protocol) server for Linear. Use it from Claude Desktop or any MCP client to create, search, update, and comment on Linear issues.

Requirements

• Node.js 18+

• A Linear API key (team settings → API)

Related MCP server: streamlinear

Setup

git clone https://github.com/aniketsharma/linear-issue-mcp.git
cd linear-issue-mcp
npm install
npm run build

Create a .env file (or set the variable in your MCP client config):

LINEAR_API_KEY=your_api_key_here

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "linear-issue-mcp"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

For local development without publishing, point command at node and args at the built entry:

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/absolute/path/to/linear-issue-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Tools

Resources

• linear-issue:///{issueId} — single issue

• linear-team:///{teamId}/issues — team backlog

• linear-user:///{userId}/assigned — assigned issues (me for current user)

• linear-organization: — org, teams, members

• linear-viewer: — authenticated user context

Example prompts

• “Show my high-priority Linear issues”

• “Create a bug report for the auth flow and assign it to the mobile team”

• “Summarize recent updates on frontend issues that are in progress”

Development

npm install
npm run build
npm run watch   # rebuild on change
npm run inspector

License

MIT — see LICENSE.