Linear MCP Server
The official Linear MCP server connects AI assistants to your Linear workspace to find, create, and update issues, projects, cycles, comments, and labels. Agents can list and read issues by team or status, triage work, manage projects and documents, and search Linear's documentation.
Install Linear
- Published by
- Official (vendor)
- Transport
- Remote (HTTP)
- Authentication
- OAuth
Claude Desktop, Claude Code and Cursor
Add this to the mcpServers object in your client's
config file, then restart the client.
{
"mcpServers": {
"linear": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
}VS Code uses a different key โ show that config
Identical entry, filed under servers rather than
mcpServers. Put it in
.vscode/mcp.json for one workspace.
{
"servers": {
"linear": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
}Before it will answer
OAuth 2.1 with dynamic client registration, or a Linear API key sent as a bearer token. For an agent that should never write, connect to https://mcp.linear.app/mcp/readonly instead of the default endpoint.
Tools
create_comment
Add a new comment to an existing issue in your Linear workspace.
create_issue
Create a new Linear issue in a chosen team or project.
create_issue_label
Create a new issue label in a Linear team or workspace.
create_project
Create a new project within a chosen team in Linear.
get_issue
Retrieve the full details of a single Linear issue.
get_project
Retrieve the details and status of a Linear project.
get_team
Retrieve the configuration and details of a specific Linear team.
get_user
Retrieve profile details for a specific Linear user.
list_comments
List all of the comments attached to a specific Linear issue.
list_cycles
List the cycles (sprints) configured for a Linear team.
list_documents
List the documents stored in your Linear workspace.
list_issue_labels
List the issue labels defined in your Linear workspace.
list_issues
List Linear issues, filterable by team, assignee, or status.
list_issue_statuses
List the workflow statuses available for a Linear team.
list_projects
List the projects in your Linear workspace or a team.
list_teams
List the teams available in your Linear workspace.
list_users
List the users that belong to your Linear workspace.
search_documentation
Search Linear's product documentation for a topic.
update_issue
Update the fields, status, or assignee of a Linear issue.
update_project
Update the properties or status of a Linear project.