MCP ConfigsMay 8, 2026·5 min read

Linear MCP — Project Management for Claude Code & Cursor

Linear's official MCP lets Claude Code, Cursor, Codex CLI manage Linear issues, projects, cycles. Search by status, create issues from chat, link PRs.

Linear
Linear · Community
Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Stage only · 5/100Stage only
Agent surface
Any MCP/CLI agent
Kind
Mcp Config
Install
Stage only
Trust
Trust: New
Entrypoint
Asset
Universal CLI install command
npx tokrepo install ed6f4647-de3c-4b1d-bf90-5f19903641c6
install contractmetadata JSONadapter planraw content
Intro

Linear's official MCP server exposes Linear's API as Model Context Protocol tools — search issues, create / update / comment, manage cycles and projects, link GitHub PRs. Configure once, every MCP-aware host (Claude Code, Cursor, Codex CLI, Cline) can manage your Linear workspace. Best for: engineering teams who want to triage / create / update Linear issues without leaving their AI coding tool. Works with: any MCP host. Setup time: 3 minutes.

MCP config

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    }
  }
}

The first time you use a Linear tool, your browser opens to authorize the MCP via Linear OAuth. Token is stored locally.

Tools exposed

Tool Use
linear_list_issues Filter by status, assignee, project, labels
linear_get_issue Full issue with comments, attachments, history
linear_create_issue Create with team, priority, assignee, labels
linear_update_issue Change status, assignee, body
linear_create_comment Comment on issue or PR-linked issue
linear_list_projects Projects with progress, due dates
linear_list_cycles Active and upcoming cycles
linear_search Full-text search across issues

Common prompts

> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."

Auth and rate limits

  • OAuth token has the same scopes as your Linear account — read what you can read, write what you can write
  • Rate limit: 1,000 requests/hour per user (Linear's standard API limit)
  • For team-shared usage, generate a Linear personal API key with restricted scopes via Settings → API instead of OAuth

FAQ

Q: Is Linear MCP free? A: Yes — the MCP server is free and official. You only need a Linear account (Linear has a free tier for ≤10 users). The MCP wraps Linear's existing API; it doesn't add billing.

Q: Does this support Linear's webhooks? A: No — webhooks are server-to-server. Linear MCP is for client-driven actions (your AI agent reading and writing). For event-driven workflows, set up Linear webhooks separately and route them into Inngest / Trigger.dev.

Q: Can my agent only see issues I have access to? A: Yes — OAuth scopes match your account. The MCP cannot escalate to issues outside your visibility. For finer-grained control, generate a scoped API key via Linear's settings.

Quick Use

  1. Add the JSON snippet below to your MCP config (~/.claude/mcp.json or equivalent)
  2. Restart your MCP host
  3. First Linear tool call triggers OAuth — authorize in browser, token cached locally

Intro

Linear's official MCP server exposes Linear's API as Model Context Protocol tools — search issues, create / update / comment, manage cycles and projects, link GitHub PRs. Configure once, every MCP-aware host (Claude Code, Cursor, Codex CLI, Cline) can manage your Linear workspace. Best for: engineering teams who want to triage / create / update Linear issues without leaving their AI coding tool. Works with: any MCP host. Setup time: 3 minutes.

MCP config

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    }
  }
}

The first time you use a Linear tool, your browser opens to authorize the MCP via Linear OAuth. Token is stored locally.

Tools exposed

Tool Use
linear_list_issues Filter by status, assignee, project, labels
linear_get_issue Full issue with comments, attachments, history
linear_create_issue Create with team, priority, assignee, labels
linear_update_issue Change status, assignee, body
linear_create_comment Comment on issue or PR-linked issue
linear_list_projects Projects with progress, due dates
linear_list_cycles Active and upcoming cycles
linear_search Full-text search across issues

Common prompts

> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."

Auth and rate limits

  • OAuth token has the same scopes as your Linear account — read what you can read, write what you can write
  • Rate limit: 1,000 requests/hour per user (Linear's standard API limit)
  • For team-shared usage, generate a Linear personal API key with restricted scopes via Settings → API instead of OAuth

FAQ

Q: Is Linear MCP free? A: Yes — the MCP server is free and official. You only need a Linear account (Linear has a free tier for ≤10 users). The MCP wraps Linear's existing API; it doesn't add billing.

Q: Does this support Linear's webhooks? A: No — webhooks are server-to-server. Linear MCP is for client-driven actions (your AI agent reading and writing). For event-driven workflows, set up Linear webhooks separately and route them into Inngest / Trigger.dev.

Q: Can my agent only see issues I have access to? A: Yes — OAuth scopes match your account. The MCP cannot escalate to issues outside your visibility. For finer-grained control, generate a scoped API key via Linear's settings.

Source & Thanks

Built by Linear. Commercial product with free tier.

linear.app/docs/mcp — Official MCP documentation

🙏

Source & Thanks

Built by Linear. Commercial product with free tier.

linear.app/docs/mcp — Official MCP documentation

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Linear MCP — Project Management for AI Agents

MCP server that connects AI agents to Linear for issue tracking, project management, and workflow automation. Create issues, update status, and query projects via natural language. 1,500+ stars.

MCP Configs
Linear

trace-mcp — Project Tracing MCP for Agents

Index a project once, then reuse maps and task context via an MCP server. Includes a CLI to init and register projects for Claude Code, Cursor, and more.

MCP Configs
MCP Hub

OpenRouter MCP — One Server for 300+ LLMs in Claude Code

OpenRouter MCP exposes all 300+ OpenRouter models to Claude Code, Cursor, Codex CLI as one MCP server. Switch models per task, BYO routing, no extra SDKs.

MCP Configs
OpenRouter

Le Chat Connectors — Slack, Notion, Drive Tools for Claude

Le Chat ships pre-validated connectors for Slack, Notion, Drive, Linear, Figma. Wire them into Claude Code or Cursor as MCP servers via le-chat-mcp.

MCP Configs
Mistral AI
◈Home🔍Search👤Me