linear-mcp-server

MCP server for Linear — full CRUD for issues, projects, cycles, teams, labels, and workflow states.

Prerequisites

Node.js >= 18
Linear API key (Settings > API > Personal API keys)

Install & Build

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

Configure in Claude Code / Cowork

Add to your MCP config (~/.claude/claude_desktop_config.json or project .mcp.json):

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/FULL/PATH/TO/linear-mcp-server/dist/index.js"],
      "env": {
        "LINEAR_API_KEY": "lin_api_YOUR_KEY_HERE"
      }
    }
  }
}

Available Tools (15 total)

Read (9)

Tool	Description
`linear_list_teams`	List all teams (get team IDs first)
`linear_list_issues`	List issues with filters (state, assignee, label)
`linear_get_issue`	Full issue detail by identifier or UUID
`linear_search_issues`	Full-text search across issues
`linear_list_projects`	List projects, optionally by team
`linear_list_cycles`	List cycles/sprints for a team
`linear_list_workflow_states`	List valid states for a team
`linear_list_labels`	List all issue labels
`linear_list_users`	List workspace members

Write (6)

Tool	Description
`linear_create_issue`	Create issue (with optional sub-issue, cycle, project)
`linear_update_issue`	Update any issue field
`linear_create_project`	Create project with team association
`linear_create_cycle`	Create cycle/sprint
`linear_add_comment`	Add comment to an issue

Usage Examples

"List all my teams" → linear_list_teams
"Show in-progress issues for team X" → linear_list_issues(team_id, state_name="In Progress")
"Create a bug ticket" → linear_create_issue(team_id, title, priority=2)
"Move issue to sprint" → linear_update_issue(issue_id, cycle_id)
"Search for auth issues" → linear_search_issues(query="authentication")

License

MIT

linear-mcp-server

linear-mcp-server

Prerequisites

Install & Build

Configure in Claude Code / Cowork

Available Tools (15 total)

Read (9)

Write (6)

Usage Examples

License

Latest Blog Posts

MCP directory API