Linear MCP server
Linear's official remote MCP server lets agents create, search, and update issues and projects.
Linear MCP is the official server from Linear, built in partnership with Cloudflare and Anthropic, that connects an agent to your Linear workspace. It lets the model work the way an engineer does in Linear: finding issues, creating and updating them, moving them through workflow states, reading project and cycle context, and leaving comments. Because Linear is where many teams plan and track engineering work, this turns an agent into a participant in that process rather than an outside observer.
The canonical deployment is the remote endpoint at https://mcp.linear.app/mcp over Streamable HTTP, with an SSE fallback at https://mcp.linear.app/sse for older clients. Authentication is OAuth 2.1 with dynamic client registration, and the server also accepts an API key or OAuth token passed directly in the Authorization bearer header for headless use.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"linear": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
}claude mcp add --transport http linear https://mcp.linear.app/mcpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| list_issues | Lists issues with advanced filtering by team, assignee, state, and more. |
| get_issue | Retrieves a single issue including its attachments and git branch info. |
| create_issue | Creates a new issue or sub-issue with title, description, and workflow metadata. |
| update_issue | Updates an existing issue's fields or moves it through workflow states. |
| list_comments | Lists the comments on an issue. |
| create_comment | Adds a comment to an issue. |
| list_projects | Lists projects with optional name filtering and pagination. |
| get_project | Retrieves the details of a project. |
| create_project | Creates a new project. |
| update_project | Updates an existing project's fields. |
| list_project_labels | Lists the project labels in the workspace. |
| list_teams | Lists the teams in the workspace. |
| get_team | Retrieves the details of a team. |
| list_users | Lists the users in the workspace. |
| get_user | Retrieves the details of a user. |
| list_issue_statuses | Lists the workflow states available to a team. |
| get_issue_status | Retrieves the details of a workflow state. |
| list_issue_labels | Lists the issue labels in the workspace. |
| create_issue_label | Creates a new issue label. |
| list_cycles | Lists the cycles (sprints) for the workspace or a team. |
| list_documents | Lists the documents in the workspace. |
| get_document | Retrieves the content of a document. |
| search_documentation | Searches Linear's product documentation to answer how-to questions. |
What you can do with it
Turn findings into tracked work
An agent that discovers a bug while coding files a properly labelled Linear issue so the work is tracked instead of lost in chat.
Status from natural language
Ask what is in flight for a cycle and the agent searches Linear and summarizes the live state of the team's work.
FAQ
- Is it free?
- The MCP server is free to connect and works within your existing Linear plan and its API limits.
- Does it support remote/OAuth?
- Yes. It is a remote server at https://mcp.linear.app/mcp using OAuth 2.1, with bearer token support for headless callers and an SSE fallback endpoint.