Skip to main content

Documentation Index

Fetch the complete documentation index at: https://portkey-docs-mintlify-bedrock-guardrails-docs-36443.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Linear’s MCP server is centrally hosted and managed, following the authenticated remote MCP specification. It supports creating, updating, and retrieving objects across Linear in a way that respects your existing permissions.

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
  • 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-remote module 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.