How to Install Linear MCP in Claude Code

Official Linear integration — create issues, manage sprints, and update project status via AI

What Linear MCP does

The official Linear MCP server connects your AI agent to your issue tracker. For engineering teams that live in Linear, this eliminates the context switch you make dozens of times a day. Features: - Create issues with full details (title, description, assignee, labels, priority) - Search and filter issues by project, assignee, status, or label - Update issue status and move through workflow states - Manage project milestones and cycles (sprints) - Add comments and link related issues - Query team workload and capacity - Access roadmap and project hierarchy - Get cycle completion metrics Use cases: - "Create a bug report for the login timeout issue with high priority, assign to me" - "What issues are in the current sprint that are blocked?" - "Move issue ENG-431 to In Review and add a comment with the PR link" - "What did the team ship last week?" Linear MCP supports OAuth for secure, per-user authentication.

linear

issues

project-management

sprints

engineering

Installation steps

1Copy the config below
2Open or create .claude/mcp.json in your project root
3Paste inside "mcpServers": {}
4Reload Claude Code

Configuration

File location: .claude/mcp.json (project root) or ~/.claude/mcp.json (global)

.claude/mcp.jsonjson

{
  "linearMcp": {
    "command": "npx",
    "args": [
      "-y",
      "@linear/mcp"
    ],
    "env": {
      "LINEAR_API_KEY": "lin_api_..."
    }
  }
}

Full server details Open Config Editor

Install in other clients

🤖Claude Desktop ⌨️Cursor 🏄Windsurf ✨OpenAI ♊Gemini

For maintainers

If you maintain Linear MCP, add this badge to your README to show it's verified on CuratedMCP:

[![CuratedMCP Verified](https://curatedmcp.com/api/badge/linear-mcp)](https://curatedmcp.com/marketplace/linear-mcp)

Related servers

Atlassian Remote MCP

Official Atlassian integration — Jira issues, Confluence docs, and your entire work graph via AI

Free

GitHub MCP

Official GitHub integration — manage repos, issues, pull requests, and workflows from your AI agent

Free

GitLab MCP

Official GitLab integration — manage CI/CD pipelines, merge requests, and issues inside AI workflows

Free