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)

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

Tool	Purpose
linear_create_issue	Create an issue (title, teamId; optional description, priority, status)
linear_update_issue	Update an issue by id
linear_search_issues	Filter by query, team, status, assignee, labels, priority
linear_get_user_issues	List issues for a user (or the authenticated user)
linear_add_comment	Comment on an issue (markdown supported)

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.