
TacticLaunch Linear MCP Server: Setup for Claude, Cursor and Other Apps
Not the official Linear MCP server. This one is built by the community. Linear makes its own: Linear →
Lets Claude, Cursor and other assistants read and change your Linear issues, projects, cycles and documents.
This is a community server for Linear, not the one Linear publishes. It runs on your computer and talks to Linear with a personal API key from your Linear settings, so there is no OAuth sign-in flow to set up for normal use.
It covers far more than issues. It also reaches projects, cycles, milestones, roadmaps, customers, documents, webhooks and OAuth apps. It has no read-only switch, so use it with a key you are happy for the assistant to act on.
Good for
- Teams who plan work in Linear and want the assistant to file and update issues
- Engineering leads who want project updates drafted from live Linear data
- Developers who prefer one local server with a very wide Linear reach
- Workspace admins who manage webhooks and OAuth apps from chat
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install mcp-linear
Claude Code
- 1
Copy this prompt.
Add the mcp-linear server to Claude Code. Run this command: claude mcp add linear -e LINEAR_API_TOKEN=<LINEAR_API_TOKEN> -- npx -y @tacticlaunch/mcp-linear Ask me for LINEAR_API_TOKEN and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Built from the package data we hold. Not yet tested by us.
Tools
Finds Linear issues by text, status, assignee or date
Searches issues with filters such as text, team, state, assignee and created or updated dates.
Try: “Find open bugs assigned to me that were updated this week.”
Read ·
linear_searchIssuesLists issues in your workspace
Returns a page of issues, optionally narrowed by team or other filters.
Try: “Show all my Linear issues.”
Read ·
linear_getIssuesOpens one issue with its details
Fetches a single issue by ID or identifier such as FE-123.
Try: “Open issue FE-123 and summarise the discussion.”
Read ·
linear_getIssueByIdCreates a new issue
Creates an issue in a team with a title, description and other fields. Every call adds a new issue.
Try: “Create an issue titled Fix login bug in the Frontend team.”
Write ·
linear_createIssueEdits an existing issue
Changes fields on an issue, such as title, description or status.
Try: “Change the status of FE-123 to In Progress.”
Write ·
linear_updateIssueAssigns an issue to someone
Sets the assignee of an issue.
Try: “Assign BE-456 to John Smith.”
Write ·
linear_assignIssueSets how urgent an issue is
Changes the priority level of an issue.
Try: “Make FE-123 urgent.”
Write ·
linear_setIssuePriorityAdds a comment to an issue
Posts a new comment on an issue.
Try: “Comment on FE-123 that the fix ships Friday.”
Write ·
linear_createCommentDeletes a comment
Deletes a comment by ID. Marked destructive in the source.
Try: “Delete my last comment on FE-123.”
Delete ·
linear_deleteCommentArchives an issue
Archives an issue so it leaves active views. Marked destructive in the source.
Try: “Archive FE-99, it is obsolete.”
Delete ·
linear_archiveIssueAdds a label to an issue
Attaches an existing label to an issue.
Try: “Label FE-123 as bug.”
Write ·
linear_addIssueLabelLinks two issues together
Creates a relation such as blocks or related between two issues.
Try: “Mark FE-123 as blocking FE-130.”
Write ·
linear_createIssueRelationShows the change history of an issue
Returns the history entries for an issue.
Try: “What changed on FE-123 this week?”
Read ·
linear_getIssueHistoryReads comments on an issue
Lists the comments on an issue.
Try: “Summarise the comments on FE-123.”
Read ·
linear_getCommentsLists your teams
Returns the teams in your workspace.
Try: “Which teams do we have in Linear?”
Read ·
linear_getTeamsLists the statuses a team uses
Returns the workflow states for a team, such as Todo and Done.
Try: “What statuses does the Backend team use?”
Read ·
linear_getWorkflowStatesLists people in your workspace
Returns workspace users.
Try: “Who is in our Linear workspace?”
Read ·
linear_getUsersLists labels
Returns the labels available in the workspace.
Try: “List our issue labels.”
Read ·
linear_getLabelsLists projects
Returns projects in your workspace.
Try: “Show all active projects.”
Read ·
linear_getProjectsLists the issues in a project
Returns issues that belong to a project.
Try: “Show open issues in the Checkout project grouped by milestone.”
Read ·
linear_getProjectIssuesCreates a project
Creates a new Linear project.
Try: “Create a project called Q4 Onboarding.”
Write ·
linear_createProjectEdits a project
Changes project fields such as name, description or status.
Try: “Move the Checkout project to completed.”
Write ·
linear_updateProjectArchives a project
Archives a project. Marked destructive in the source.
Try: “Archive the old Beta project.”
Delete ·
linear_archiveProjectPosts a project status update
Creates a project update, such as a weekly status note.
Try: “Draft a weekly update for the Checkout project from its current state.”
Write ·
linear_createProjectUpdateDeletes a project update
Deletes a project update. Marked destructive in the source.
Try: “Delete the draft update I posted by mistake.”
Delete ·
linear_deleteProjectUpdateLists cycles (sprints)
Returns cycles for a team.
Try: “Show the current and next cycles for Backend.”
Read ·
linear_getCyclesShows how a cycle is going
Returns statistics for a cycle.
Try: “How is the active cycle tracking?”
Read ·
linear_getCycleStatsMoves an issue into a cycle
Adds an issue to a cycle.
Try: “Add FE-123 to the current cycle.”
Write ·
linear_addIssueToCycleLists project milestones
Returns milestones for a project.
Try: “List milestones for the Checkout project.”
Read ·
linear_getMilestonesCreates a milestone
Adds a milestone to a project.
Try: “Add a Beta milestone to Checkout due December 1.”
Write ·
linear_createMilestoneSearches Linear documents
Searches documents across the workspace.
Try: “Find the newest documents about the pricing project and summarise the decisions.”
Read ·
linear_searchDocumentsCreates a document
Creates a document in Linear.
Try: “Create a document for ENG-123 with the design notes.”
Write ·
linear_createDocumentEdits a document
Updates the content or title of a document.
Try: “Add a decisions section to the pricing doc.”
Write ·
linear_updateDocumentArchives (trashes) a document
Moves a document to the trash. Marked destructive in the source.
Try: “Archive the old onboarding doc.”
Delete ·
linear_archiveDocumentLists initiatives
Returns initiatives in the workspace.
Try: “List all active initiatives.”
Read ·
linear_getInitiativesPosts an initiative update
Creates an update on an initiative.
Try: “Create an initiative update for Q4 growth.”
Write ·
linear_createInitiativeUpdateDeletes an initiative
Moves an initiative to the trash. Marked destructive in the source.
Try: “Delete the test initiative.”
Delete ·
linear_deleteInitiativeLists roadmaps
Returns roadmaps in the workspace.
Try: “Show our roadmaps.”
Read ·
linear_getRoadmapsLists customers
Returns customer records.
Try: “Which customers have open needs?”
Read ·
linear_getCustomersRecords a customer need
Creates a customer need linked to an issue or project.
Try: “Log that Acme needs SSO, linked to ENG-200.”
Write ·
linear_createCustomerNeedDeletes a customer
Deletes a customer record. Marked destructive in the source.
Try: “Delete the duplicate Acme customer.”
Delete ·
linear_deleteCustomerLists workspace webhooks
Returns the workspace webhooks.
Try: “List our webhooks.”
Read ·
linear_getWebhooksCreates a webhook
Creates a workspace webhook for chosen events. The URL must be a public HTTPS address.
Try: “Create a webhook for Issue and Comment events.”
Write ·
linear_createWebhookDeletes a webhook
Deletes a webhook. Marked destructive in the source.
Try: “Delete the old staging webhook.”
Delete ·
linear_deleteWebhookReplaces a webhook signing secret
Creates a new signing secret and invalidates the old one. The new secret is returned to the assistant.
Try: “Rotate the signing secret for our CI webhook.”
Delete ·
linear_rotateWebhookSecretSigns out every session on your account
Revokes all your Linear sessions. Marked destructive in the source.
Try: “Sign out all my Linear sessions.”
Delete ·
linear_logoutAllSessionsReads the workspace audit log
Returns audit events for the organization.
Try: “Show recent audit events for our workspace.”
Read ·
linear_getOrganizationAuditEventsShows your Linear API usage limits
Reports the current Linear rate limit status.
Try: “How much of our Linear rate limit is left?”
Read ·
linear_getRateLimitStatus
Read from the source code
Permissions
high risk · 4 things to watch
High risk
The assistant can read, change and delete almost anything your Linear key can reach, including issues, projects, documents, customers and webhooks. Use a key from a limited account and leave tool approval on, because there is no read-only mode.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete and archive Linear data
About 30 of the 195 tools archive or delete issues, projects, documents, customers and webhooks, or sign sessions out. Use a key from an account with limited access, and keep approval prompts on in your assistant. github.com
No read-only mode
The README documents no read-only switch, and the source annotates the delete tools as destructive rather than hiding them. Every call runs with the full rights of your key. github.com
It can reveal secrets and issue tokens
Creating or rotating OAuth apps and webhook secrets returns secret values to the assistant. Those tools ask for an explicit confirmation flag. Store returned secrets in a secret manager. github.com
Your key sits in the app config
The API key goes into the MCP config file or an environment variable on your machine. Treat that file like a password. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Talks to | api.linear.app |
|---|---|
| Sign-in and keys | The key is read from the LINEAR_API_TOKEN environment variable or the --token flag. Nothing is stored by the server. |
| Scopes |
|
Questions
Is this the official Linear MCP server?
No. It is a community project by TacticLaunch. Linear publishes its own hosted server at the address on the Linear page, which signs in with your Linear account instead of an API key.
What do I need to run it?
Node.js and a Linear personal API key. Create the key in Linear under Settings, then Security and access, then Personal API Keys, and put it in the LINEAR_API_TOKEN setting shown in the install box. A managing OAuth app token also works for the OAuth app tools.
Can it run read-only?
No. The README documents no read-only mode. To limit damage, use a key from an account with restricted access and keep approval prompts on.
Does it run on my computer or in the cloud?
It runs locally on your computer and talks to Linear directly with your key. Your assistant still sends the Linear data it reads to your AI provider.
Can it delete things in Linear?
Yes. It has tools that archive or delete issues, projects, documents, customers, webhooks and initiatives, and tools that sign sessions out. Your assistant should ask you before it runs them, so keep approvals on.
Which tools are listed here?
A selection of the main ones, not all 195. The full inventory is in the project's TOOLS.md file.
How do I add it to Claude or Cursor?
Use the install box above and set your Linear key in the environment setting. Restart the app afterwards so it loads the tools.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
@tacticlaunch/mcp-linear- Registry
- npm
- Transport
- stdio
- Auth
- API key
- Version
- 1.4.5
- License
- MIT
- Last commit
- Oct 12, 2026
- Open issues
- 0
Other Linear MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- README.md · github.com
- issue-tools.ts · github.com
- tool-annotations.ts · github.com