Linear MCP Server
for AI Agents

Retrieve agent sessions with cursor pagination

Retrieve a specific agent session by ID

Link an external resource to an issue as an attachment

Edit an existing attachment's title, subtitle, icon, or metadata (does NOT remove it — use delete_attachment to remove/detach an attachment)

Remove (delete) an attachment from its issue by attachment ID — this is the action for a 'remove/delete this attachment' request

Create a new comment on an issue

Retrieve comments with optional filtering and cursor pagination

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 customers with optional filtering and cursor pagination

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 customer needs with optional filtering and cursor pagination

Retrieve the full details of a specific customer need by its ID (call this after list_customer_needs to return the requested details)

Update a customer need's body, priority, customer, or the issue/project it is linked to

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 customer tiers with cursor pagination

Retrieve a specific customer tier by its ID (resolve a tier name to its ID via list_customer_tiers first)

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

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 cycles with optional filtering and cursor pagination

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 documents with optional filtering and cursor pagination

Retrieve a specific document by ID

Update an existing document's title, content, or associations (does NOT trash a document — use delete_document to move a document to trash)

Move a document to trash by ID — this is the action for a 'move to trash', 'trash this document', or 'delete document' request

Retrieve external users for the organization with cursor pagination

Retrieve a specific external user by ID

Add an item (issue, project, cycle, custom view, document, label, or user) to the user's favorites

Retrieve the authenticated user's favorites, including the subject each one points to

Remove an item from favorites by favorite ID

Create a new initiative to group projects

Retrieve initiatives with optional filtering and cursor pagination

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 issues with optional filtering by team, project, assignee, or status and cursor pagination

Retrieve a specific issue by ID or identifier

Search issues by text term with optional filtering and cursor pagination

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

Create multiple issues at once

Update multiple issues at once by their UUIDs

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 issue labels with optional filtering and cursor pagination

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 projects in the workspace with optional filtering and cursor pagination

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 project labels with optional filtering and cursor pagination

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 project milestones with optional filtering and cursor pagination

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 teams in the workspace with optional filtering and cursor pagination

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

List the memberships of a team, returning each membership's ID alongside its user — needed to remove a user from a team

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 users in the workspace with optional filtering and cursor pagination, use the filter input to search.

Retrieve a specific user by ID

Update your own Linear user profile, status, or display settings

Create a new webhook to receive HTTP notifications for data updates

Retrieve webhooks in the organization with cursor pagination

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 workflow states with optional filtering and cursor pagination

Retrieve a specific workflow state by ID

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