67 available actions
What your AI agent can do in Linear MCP
Linear MCP lets agents find, create, and update issues, projects, comments, and related planning objects in a Linear workspace. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 67 actions.
Common starting points
- Search documentationSearch Linear's documentation to learn about features and usage
- Get agent skillRetrieve a Linear Agent skill by ID, including its full markdown instructions.
- Submit diff reviewApprove a Linear diff, request changes, or submit a review comment
- Create attachmentDeprecated fallback for tiny files only.
- Save customerCreate or update a Linear customer.
- Save customer needCreate or update a customer need (request) in Linear.
Browse all 67 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 38 actions
- Get agent skillRetrieve a Linear Agent skill by ID, including its full markdown instructions.
- Get attachmentRetrieve an attachment's content by ID.
- Get diffExact lookup for a Linear diff.
- Get diff threadsExact lookup for diff threads and the authenticated user's drafts.
- Get documentRetrieve a Linear document by ID or slug
- Get initiativeRetrieve detailed information about a specific initiative in Linear
- Get issueRetrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligence suggestions when the issue is in triage
- Get issue statusRetrieve detailed information about an issue status in Linear by name or ID
- Get milestoneRetrieve details of a specific milestone by ID or name
- Get projectRetrieve details of a specific project in Linear
- Get releaseRetrieve details of a release by ID or slug.
- Get release noteRetrieve release notes by ID or slug, including markdown content.
- Get status updatesList or get project/initiative status updates.
- Get teamRetrieve details of a specific Linear team
- Get templateRetrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fields.
- Get userRetrieve details of a specific Linear user
- Get workspaceRetrieve the connected Linear workspace
- List agent skillsList Linear Agent skills available to the authenticated user.
- List commentsList comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update.
- List customersList customers in the user's Linear workspace
- List cyclesRetrieve cycles for a specific Linear team
- List diffsList Linear diff pull requests visible to the authenticated user
- List documentsList documents in the user's Linear workspace
- List initiative labelsList available initiative labels in the Linear workspace
- List initiativesList initiatives in the user's Linear workspace
- List issue labelsList available issue labels in a Linear workspace or team
- List issuesList issues in the user's Linear workspace, including active Triage Intelligence suggestions for issues in triage.
- List issue statusesList available issue statuses in a Linear team
- List milestonesList all milestones in a Linear project
- List project labelsList available project labels in the Linear workspace
- List projectsList projects in the user's Linear workspace
- List release notesList release notes in the workspace, optionally filtered by pipeline or covered release.
- List release pipelinesList release pipelines in the workspace.
- List releasesList releases in the workspace, with optional filtering by pipeline, stage, version, and text.
- List teamsList teams in the user's Linear workspace
- List templatesList the Linear issue, project, and document templates available to the authenticated user.
- List usersRetrieve users in the Linear workspace
- Search documentationSearch Linear's documentation to learn about features and usage
Create & communicateCreate records or send supported messagesView 5 actions
- Create attachmentDeprecated fallback for tiny files only.
- Create attachment from uploadLink an already-uploaded Linear assetUrl to an existing issue as an attachment.
- Create initiative labelCreate a new Linear initiative label
- Create issue labelCreate a new Linear issue label
- Submit diff reviewApprove a Linear diff, request changes, or submit a review comment
Update & manageChange and manage existing recordsView 13 actions
- Merge diffMerge a Linear diff or add it to the repository's merge queue
- Save commentCreate or update a comment on a Linear issue, project, initiative, document, project milestone, or project/initiative status update.
- Save customerCreate or update a Linear customer.
- Save customer needCreate or update a customer need (request) in Linear.
- Save diff commentCreate, reply to, or edit a comment or persisted draft on a Linear diff.
- Save documentCreate or update a Linear document.
- Save initiativeCreate or update a Linear initiative.
- Save issueCreate or update a Linear issue.
- Save milestoneCreate or update a milestone in a Linear project.
- Save projectCreate or update a Linear project.
- Save releaseCreate or update a release.
- Save release noteCreate or update release notes.
- Save status updateCreate or update a project/initiative status update.
Remove & cancelRemove records or cancel supported workView 6 actions
- Delete attachmentDelete an attachment by ID
- Delete commentDelete a Linear comment.
- Delete customerDelete a customer in Linear
- Delete customer needArchive a customer need in Linear
- Delete diff commentDelete a comment or persisted draft from a Linear diff
- Delete status updateDelete (archive) a project or initiative status update.
Other actionsSpecialist and administrative actions.View 5 actions
- Extract imagesExtract and fetch images from markdown content.
- Prepare attachment uploadPrepare a direct Linear file upload for an existing issue.
- Resolve diff threadResolve or reopen a top-level comment thread on a Linear diff
- Share issueShare an issue with a workspace user who cannot otherwise access it.
- Unshare issueRemove a workspace user's shared access to an issue.
Connection record
A connection you can control.
- Sign-in
- OAuth sign-in
- Setup
- Sign in with your own Linear MCP account. Access is limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Linear MCP
How does the agent connect to Linear MCP?
You sign in with your own Linear MCP account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Linear MCP at any time.
What can the agent actually do in Linear MCP?
The page above lists the 67 actions currently available through the Linear MCP connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Linear MCP included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Linear MCP is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Linear MCP to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.