Linear MCP Server
for AI Agents

Retrieve all agent sessions

Retrieve a specific agent session by ID

Link an external resource to an issue as an attachment

Update an existing attachment's title, subtitle, icon, or metadata

Delete an attachment by ID

Create a new comment on an issue

Retrieve all comments with optional filtering by issue

Retrieve a specific comment by ID

Update an existing comment's body

Delete a comment by ID

Create a new customer with name, domains, and optional revenue, size, status, and tier

Retrieve all customers with optional filtering

Retrieve a specific customer by ID

Update an existing customer's name, domains, revenue, size, status, or tier

Delete a customer by ID

Create a new customer need attached to an issue, project, or comment

Retrieve all customer needs with optional filtering

Retrieve a specific customer need by ID

Update an existing customer need's body or customer association

Delete a customer need by ID

Create a new customer status with a color and a name or displayName, plus optional description and position

Retrieve a specific customer status by ID

Update an existing customer status's name, description, color, or position

Delete a customer status by ID

Create a new customer tier with name and optional description

Retrieve all customer tiers

Retrieve a specific customer tier by ID

Update an existing customer tier's name or description

Delete a customer tier by ID

Create a new saved custom view with filters

Update an existing custom view's name, filters, or sharing settings

Delete a custom view by ID

Create a new cycle for a team

Retrieve all cycles with optional filtering by team

Retrieve a specific cycle by ID

Update an existing cycle's name, description, or dates

Create a new document with title, content, and optional project or initiative association

Retrieve all documents with optional filtering

Retrieve a specific document by ID

Update an existing document's title, content, or associations

Delete (trash) a document by ID

Retrieve all external users for the organization

Retrieve a specific external user by ID

Add an item (issue, project, cycle, custom view, etc.) to the user's favorites

Remove an item from favorites by favorite ID

Create a new initiative to group projects

Retrieve all initiatives with optional filtering

Retrieve a specific initiative by ID

Update an existing initiative's name, description, dates, or other properties

Delete an initiative by ID

Link an initiative to a project

Remove the link between an initiative and a project

Create a new issue in Linear with title, description, team, and optional fields

Retrieve all issues with optional filtering by team, project, assignee, or status

Retrieve a specific issue by ID or identifier

Search issues by text term with optional filtering and pagination

Update an existing issue's title, description, assignee, priority, state, or other fields

Create multiple issues at once

Update multiple issues at once

Delete an issue by ID

Create a relationship between two issues

Remove a relationship between two issues

Create a new issue label for a team

Retrieve all issue labels with optional filtering by team

Retrieve a specific issue label by ID

Update an existing issue label's name, description, or color

Delete an issue label by ID

Create a new project with name, description, and optional team associations

Retrieve all projects in the workspace with optional filtering

Retrieve a specific project by ID with full details

Update an existing project's details

Delete a project by ID

Create a new project label

Retrieve all project labels with optional filtering

Retrieve a specific project label by ID

Update an existing project label's name, description, or color

Delete a project label by ID

Create a new milestone for a project

Retrieve all milestones for a project

Retrieve a specific project milestone by ID

Update an existing project milestone's name, description, or target date

Delete a project milestone by ID

Create a new project status with name, type, and optional description, color, and position

Retrieve a specific project status by ID

Update an existing project status's name, description, type, color, or position

Add an emoji reaction to a comment, issue, or project update

Remove an emoji reaction by reaction ID

Create a new release in a pipeline

Update an existing release's name, version, description, or other properties

Delete a release by ID

Create a new team with name and optional settings

Retrieve all teams in the workspace

Retrieve a specific team by ID

Update an existing team's name, description, icon, color, or other properties

Delete a team by ID

Add a user to a team, with optional owner role assignment

Remove a user from a team

Create a new issue or project template

Update an existing template's name, description, data, or other properties

Delete a template by ID

Retrieve all users in the workspace, use the filter input to search.

Retrieve a specific user by ID

Update an existing user's profile, status, or display settings

Create a new webhook to receive HTTP notifications for data updates

Retrieve all webhooks in the organization

Retrieve a specific webhook by ID

Update an existing webhook's URL, enabled status, or resource types

Delete a webhook by ID

Create a new workflow state for a team with a specified type, name, and color

Retrieve all workflow states with optional filtering by team

Retrieve a specific workflow state by ID

Update an existing workflow state's name, color, description, or position