Linear MCP Server
Turn issues, projects, and cycles into tools your AI agents can act on.
Updated
What is Linear MCP?
The Linear MCP server is Linear's official Model Context Protocol server. It exposes your Linear workspace — issues, projects, cycles, teams, and comments — to AI agents as tools, so an assistant can create and update issues, search your backlog, and report on project status without you leaving the conversation.
Linear hosts the server at https://mcp.linear.app/mcp and you connect it with OAuth, so there's no token to manage and nothing to deploy.
Tools the Linear MCP server exposes
| Tool | What it does |
|---|---|
| list_issues | Search and list issues with filters (assignee, status, team, label) |
| create_issue | Create a new issue with title, description, team, and assignee |
| update_issue | Update an issue's status, assignee, labels, or estimate |
| list_projects | List projects and their progress |
| create_comment | Add a comment to an issue |
| list_cycles | List cycles and the issues within them |
| search | Full-text search across the workspace |
Connect the Linear MCP server
Connect Linear MCP to Claude Code
- 1
Add the server
Run `claude mcp add --transport http linear https://mcp.linear.app/mcp`.
- 2
Authorize
Complete the OAuth flow in the browser to grant access to your Linear workspace.
- 3
Verify
Ask Claude to "list my assigned Linear issues" to confirm the tools work.
Connect Linear MCP to Cursor
- 1
Add an MCP server
In Cursor Settings → MCP, add `https://mcp.linear.app/mcp` as a streamable HTTP server.
- 2
Sign in
Complete the Linear OAuth authorization.
- 3
Test
Create a test issue from chat to confirm write access.
Sample use cases
A bug report comes in from support
The agent creates a well-formed Linear issue on the right team with a clear description and labels.
Sprint planning summary
The agent lists the current cycle's issues and reports what's at risk of slipping.
Turning a PR into a tracked task
From your editor, the agent files a Linear issue and links it to the work in progress.
Security & permissions
The Linear MCP server uses OAuth, so you authorize it against your Linear account without handling a static API key. The integration acts with your permissions in the workspace — it can see and change what you can. Review and revoke access at any time from Linear's Settings → API → Authorized applications. For automated, multi-user setups, connect it through a platform like Gamut that manages the OAuth grant centrally rather than per-developer.
Using Linear MCP with Gamut
On Gamut, the Linear MCP server becomes part of an automated workflow rather than a manual chat tool. An agent can be triggered by an inbound support ticket, a failing test, or a schedule, then create or update Linear issues, comment with context pulled from your other connected MCP servers, and keep cycles tidy — with the OAuth connection and triggers managed by Gamut so the work happens without a person filing tickets by hand.
Frequently asked questions
What is the Linear MCP server?
Linear's official Model Context Protocol server, which exposes issues, projects, cycles, and search to AI agents as tools they can read and write.
Is the Linear MCP server free?
Yes. The hosted server at mcp.linear.app is free to connect with OAuth on any Linear plan; normal API rate limits apply.
How do I add the Linear MCP to Claude Code?
Run `claude mcp add --transport http linear https://mcp.linear.app/mcp` and complete the OAuth sign-in.
Can the Linear MCP server create issues?
Yes — it can create and update issues, add comments, and manage cycles, acting with your Linear permissions.