When should you use it?
Use the Linear MCP server when you want to:- Search and retrieve issues, projects, cycles, and documents from Linear.
- Create and update issues, projects, or comments via natural language commands.
- Integrate Linear data directly into AI-powered workflows (e.g., task planning, meeting follow-ups).
- Provide secure, real-time access to Linear data without custom integrations.
Endpoints
-
Transport options:
-
HTTP:
https://mcp.linear.app/mcp -
SSE:
https://mcp.linear.app/sse
-
HTTP:
- Authentication: OAuth 2.1 with dynamic client registration.
- Recommendation: Use the streamable HTTP endpoint where supported for improved reliability.
-
Compatibility: Works natively with Claude, Cursor, and other MCP clients. For older clients, the
mcp-remotemodule ensures backwards compatibility.
Tools
list_comments — Retrieve a list of comments.
create_comment — Create a new comment.
list_cycles — Retrieve all cycles.
get_document — Retrieve a specific document.
list_documents — List all documents.
get_issue — Get details of a specific issue.
list_issues — List issues in the workspace.
create_issue — Create a new issue.
update_issue — Update an existing issue.
list_issue_statuses — Retrieve all available issue statuses.
get_issue_status — Retrieve details of a specific issue status.
list_my_issues — List issues assigned to the authenticated user.
list_issue_labels — Retrieve all available issue labels.
list_projects — List all projects.
get_project — Retrieve details of a specific project.
create_project — Create a new project.
update_project — Update an existing project.
list_teams — List all teams.
Notes
- The server is centrally hosted by Linear; no local deployment is required.
- Supports both SSE and HTTP transports, though HTTP is recommended.