PlugWiki
mcp-linear logo

TacticLaunch Linear MCP Server: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpm@tacticlaunch/mcp-lineartacticlaunch/mcp-linear

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.

Install mcp-linear

Claude Code

  1. 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. 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_searchIssues

  • Lists issues in your workspace

    Returns a page of issues, optionally narrowed by team or other filters.

    Try: “Show all my Linear issues.”

    Read · linear_getIssues

  • Opens 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_getIssueById

  • Creates 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_createIssue

  • Edits 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_updateIssue

  • Assigns an issue to someone

    Sets the assignee of an issue.

    Try: “Assign BE-456 to John Smith.”

    Write · linear_assignIssue

  • Sets how urgent an issue is

    Changes the priority level of an issue.

    Try: “Make FE-123 urgent.”

    Write · linear_setIssuePriority

  • Adds a comment to an issue

    Posts a new comment on an issue.

    Try: “Comment on FE-123 that the fix ships Friday.”

    Write · linear_createComment

  • Deletes a comment

    Deletes a comment by ID. Marked destructive in the source.

    Try: “Delete my last comment on FE-123.”

    Delete · linear_deleteComment

  • Archives an issue

    Archives an issue so it leaves active views. Marked destructive in the source.

    Try: “Archive FE-99, it is obsolete.”

    Delete · linear_archiveIssue

  • Adds a label to an issue

    Attaches an existing label to an issue.

    Try: “Label FE-123 as bug.”

    Write · linear_addIssueLabel

  • Links two issues together

    Creates a relation such as blocks or related between two issues.

    Try: “Mark FE-123 as blocking FE-130.”

    Write · linear_createIssueRelation

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 toapi.linear.app
Sign-in and keysThe key is read from the LINEAR_API_TOKEN environment variable or the --token flag. Nothing is stored by the server.
Scopes
  • Linear personal API key (LINEAR_API_TOKEN) or OAuth access token

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

GitHubnpmChangelogIssues

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 3
  1. README.md · github.com
  2. issue-tools.ts · github.com
  3. tool-annotations.ts · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.