Linear

Manage Linear issues, projects, and cycles from your AI client.

Works with: Claude DesktopClaude CodeCursorWindsurf

How to install the Linear MCP server

Add this to your Claude Desktop MCP configuration:

Connect via OAuth in Claude Desktop integrations panel.

Add this to your Claude Code MCP configuration:

Connect via OAuth in Claude Desktop integrations panel.

Add this to your Cursor MCP configuration:

Connect via OAuth in Claude Desktop integrations panel.

Add this to your Windsurf MCP configuration:

Connect via OAuth in Claude Desktop integrations panel.

The Linear MCP server is Linear’s official integration. It gives Claude full read/write access to your Linear workspace via OAuth: issues, projects, cycles, comments, and team views. For solo founders and small teams running Linear, this is one of the higher-leverage integrations.

Why use it

Linear is opinionated about issue management. The MCP server matches that ethos: it surfaces structured fields (priority, cycle, assignee) Claude can reason about. “What’s at risk in this cycle?” produces a clear answer instead of a wall of text.

For weekly check-ins, project status reports, and “what should I work on next?” prompts, the Linear server replaces several minutes of manual filtering with one prompt.

What it actually does

Read and create issues, query projects, list cycles, comment on issues, search by label or status, assign work. Pair with the GitHub MCP server for an end-to-end “issue → branch → PR → close issue” flow.

Practical patterns:

  • “Show me all P1 issues in the current cycle that haven’t been started.”
  • “Create a Linear issue titled ‘fix sitemap lastmod’ with high priority, assign to me.”
  • “Summarize what closed in last week’s cycle and what’s slipping.”

Gotchas

OAuth scopes can’t be expanded mid-session. Configure them right at setup. Linear’s default scopes are read-mostly; explicitly grant write if you want issue creation.

Rate limits on the Linear API apply per workspace. Heavy “summarize everything” queries can hit them. Scope queries to specific cycles or teams to stay efficient.

Example prompts for the Linear MCP server

Show me all P1 issues assigned to me this cycle.

Create a Linear issue for 'fix sitemap lastmod bug', priority high.

What's blocked on the Q2 roadmap?

Linear MCP server: FAQs

How is auth handled?

OAuth via Linear's integrations panel. No API keys to manage. Claude Desktop opens the Linear consent screen, you approve scopes, the connection persists.

Can it create issues?

Yes. With write scopes the server can create, update, comment, and assign issues. Defaults are conservative; expand scopes only if you need them.

Does it work with cycles and roadmaps?

Yes. Claude can query active cycles, list issues per cycle, and check roadmap progress. Useful for weekly planning prompts.

Can multiple workspaces connect?

One workspace per OAuth connection. If you work in multiple, configure separate connections in Claude Desktop and pick the right one per query.

How is it different from Linear's web search?

Web search is good. The MCP integration lets Claude reason across issues, summarize cycles, and synthesise project status without you copying anything out.