Skip to main content
The Linear MCP Server connects AI agents to Linear’s project management platform, enabling automated creation, retrieval, and updating of Linear objects such as issues, projects, milestones, documents, initiatives, cycles, teams, and comments. Built on the authenticated remote MCP spec, it provides a secure, centrally hosted interface that allows AI agents within Caylex to interact with your full Linear workspace. Authentication is handled via OAuth 2.1, so once connected in Caylex your agents can read and write Linear data without manual credential management. This server is well-suited for automating project reporting, managing documentation, tracking initiative progress, and orchestrating issue workflows across teams.
Prerequisites:
  • A Linear account is required; access to workspace data depends on the permissions of the authenticated user.
  • To generate a personal API key (if using header-based auth), navigate to Linear Settings > Account > Security & Access.
Important API details:
  • Authentication uses OAuth 2.1 with dynamic client registration — Caylex handles the OAuth flow on your behalf.
  • The server is centrally hosted and managed by Linear, meaning tool availability and behavior may be updated by Linear independently.
  • More functionality is actively being added to the server; some advanced Linear features may not yet be exposed as tools.
  • For Jules-style API key authentication, a personal API key can be generated under Linear Settings > Account > Security & Access.

​
Server Details

​
Authentication

This server supports the following authentication method:

​
OAuth

Scopes: read, write, issues:create, comments:create, timeSchedule:write During the server onboarding flow, you will be prompted to complete the OAuth flow to grant access. See the Linear Authentication guide for step-by-step credential configuration.

​
Getting Started

1

Add the server

Navigate to the Server Library and click on the New Server button. Find Linear in the Caylex Catalog.
2

Server Onboarding flow

Go through the server onboarding flow.
3

Use in a project

Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.

​
Available Tools

This server provides 38 tools:

​
Issues

Retrieve detailed information about an issue by ID, including attachments and git branch name
Create or update a Linear issue. If id is provided, updates the existing issue; otherwise creates a new one. When creating, title and team are required.
List issues in the user’s Linear workspace. For my issues, use “me” as the assignee. Use “null” for no assignee.
List available issue statuses in a Linear team
Retrieve detailed information about an issue status in Linear by name or ID
List available issue labels in a Linear workspace or team
Create a new Linear issue label

​
Comments

List comments for a specific Linear issue
Create or update a comment on a Linear issue. If id is provided, updates the existing comment; otherwise creates a new one. When creating, issueId and body are required.
Delete a comment from a Linear issue

​
Projects

Retrieve details of a specific project in Linear
List projects in the user’s Linear workspace
Create or update a Linear project. If id is provided, updates the existing project; otherwise creates a new one. When creating, name and at least one team (via addTeams or setTeams) are required.
List available project labels in the Linear workspace

​
Documents

List documents in the user’s Linear workspace
Retrieve a Linear document by ID or slug
Create a new document in Linear
Update an existing Linear document
Search Linear’s documentation to learn about features and usage

​
Milestones

Retrieve details of a specific milestone by ID or name
List all milestones in a Linear project
Create or update a milestone in a Linear project. If id is provided, updates the existing milestone; otherwise creates a new one. When creating, name is required.

​
Initiatives

List initiatives in the user’s Linear workspace
Retrieve detailed information about a specific initiative in Linear
Create or update a Linear initiative. If id is provided, updates the existing initiative; otherwise creates a new one. When creating, name is required.

​
Cycles

Retrieve cycles for a specific Linear team

​
Status Updates

List or get project/initiative status updates. Pass id to get a specific update, or filter to list.
Create or update a project/initiative status update. Omit id to create, provide id to update.
Delete (archive) a project or initiative status update.

​
Attachments

Create a new attachment on a specific Linear issue by uploading base64-encoded content.
Retrieve an attachment’s content by ID.
Delete an attachment by ID
Extract and fetch images from markdown content. Use this to view screenshots, diagrams, or other images embedded in Linear issues, comments, or documents. Pass the markdown content (e.g., issue description) and receive the images as viewable data.

​
Teams

Retrieve details of a specific Linear team
List teams in the user’s Linear workspace

​
Users

Retrieve details of a specific Linear user
Retrieve users in the Linear workspace
Retrieve the profile of the currently authenticated user

Github

Slack

Notion

​
References

https://linear.app/docs/mcp

https://developers.linear.app/docs/ai/mcp-server