Linear MCP (multi-workspace, PAT auth) MCP server
Multi-workspace Linear MCP — PAT auth, 57 tools + 3 prompts, substrate enforcement, drop-in.
1 stars25 downloads/wk
Reviews
Write oneNobody has reviewed Linear MCP (multi-workspace, PAT auth) yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Linear MCP (multi-workspace, PAT auth) tools (57, 16 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
archive_notificationArchive a notification (removes from inbox; reversible).
attachments_for_urlReverse lookup: every attachment record across the workspace pointing at this URL. Useful to find which issue references a given Slack thread / PR / external doc.
bulk_save_issuesApply the same update to multiple issues in one round-trip.
create_agent_session_on_commentwrite actioncreate_agent_session_on_issuewrite actionOpen an agent session attached to an issue.
create_issue_labelwrite actionCreate a new issue label.
create_issue_relationwrite actionCreate a relation between two issues.
create_webhookwrite actionCreate a webhook subscription.
delete_attachmentwrite actionDelete an attachment. Destructive — uses draft+confirm.
delete_issue_relationwrite actionDelete an issue relation by ID. Non-destructive (no cascade).
delete_webhookwrite actionDelete a webhook. Destructive — uses draft+confirm.
get_agent_sessionGet an agent session by UUID.
get_attachmentGet one attachment by UUID.
get_documentGet a document by UUID.
get_initiativeGet an initiative by UUID.
get_issueGet a single issue.
get_issue_statusReturn the current workflow state for one issue (id or identifier).
get_milestoneGet a project milestone by UUID.
get_notificationGet one notification by UUID.
get_projectGet a Linear project by UUID.
get_teamGet a Linear team by its UUID. Includes workflow states inline.
get_userGet a Linear user by ID. Pass `me` to look up the PAT owner.
get_webhookGet a webhook by UUID.
healthcheckVerify PAT validity for each workspace + report draft store + audit log path.
link_url_to_issueAttach an arbitrary URL to an issue.
list_agent_sessionsList agent sessions. `issue_id` scopes to one issue.
list_attachmentsList attachments on one issue.
list_commentsList comments. Scope by `issue_id` or `project_id`.
list_cyclesList cycles, optionally scoped to one team.
list_documentsList documents in the workspace.
list_initiativesList initiatives in the workspace.
list_issue_labelsList issue labels. `team_id` scopes to one team; omit for org-wide.
list_issue_relationsList issue relations. `issue_id` filters to relations involving one issue.
list_issue_statusesList workflow states (issue statuses) per team.
list_issuesList issues with common filters.
list_milestonesList project milestones. `project_id` scopes to one project.
list_notificationsList notifications in the viewer's inbox.
list_projectsList projects.
list_teamsList teams in a Linear workspace.
list_usersList users in a Linear workspace.
list_webhooksList webhooks configured for the workspace.
list_workspacesList configured Linear workspaces with PAT prefix + primary status.
mark_all_notifications_readMark every notification in the inbox as read.
mark_notification_readMark a notification read (or unread by passing `read=False`).
notifications_unread_countReturn the count of unread notifications in the inbox.
save_commentwrite actionCreate or update a comment.
save_documentwrite actionCreate or update a document.
save_initiativewrite actionCreate or update an initiative.
save_issuewrite actionCreate or update an issue.
save_milestonewrite actionCreate or update a project milestone.
save_projectwrite actionCreate or update a Linear project.
save_status_updatewrite actionPost a status update against a project.
search_documentsFull-text search across workspace documents (NOT Linear's dev docs).
search_issuesFull-text search across issues in the workspace.
search_projectsFull-text search across projects in the workspace.
semantic_searchSemantic search across the entire workspace.
update_webhookwrite actionUpdate an existing webhook by UUID.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan30 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 8 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Linear MCP (multi-workspace, PAT auth) compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 1,119 Developer tools servers
- Tools
- 57
- the typical Developer tools server has 7
- Tools that change things
- 28%
- typical: 5%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 50% of 854 Developer tools servers
- Downloads a week
- 25
- more than 9% of 430 Developer tools servers with a package
What its tools let an agent do: 38 read · 12 create · 3 change · 4 delete
Install Linear MCP (multi-workspace, PAT auth) in Claude Code, Cursor or VS Code
claude mcp add linear-mcp -- uvx adelaidasofia-linear-mcp
What the publisher says
From the Linear MCP (multi-workspace, PAT auth) repository's README, as published. We do not edit it. Read it on GitHub
linear-mcp
<!-- mcp-name: io.github.adelaidasofia/linear-mcp -->
Multi-workspace Linear MCP server with Personal API Key auth. Drop-in replacement for the official OAuth-only Linear MCP at mcp.linear.app/mcp.
Why this exists. The official Linear MCP is OAuth-only and single-workspace per instance. PAT auth plus persistent token storage plus multi-workspace routing kills three failure modes:
- The OAuth flow is brittle across MCP client session boundaries — auth state expires when a session resumes mid-flow.
- The localhost callback fails in some setups, forcing fragile paste-back flows.
- One MCP instance per workspace doubles config + OAuth dances.
This server replaces both with one entry. One install, N workspaces, never an OAuth dance again.
Install
From PyPI
pipx install adelaidasofia-linear-mcpFrom source
git clone https://github.com/adelaidasofia/linear-mcp ~/.claude/linear-mcp
cd ~/.claude/linear-mcp
pip install -e .Claude Desktop one-click
Download the latest .mcpb from Releases and double-click.
Configure
- Generate one Personal API Key per workspace at . You must be logged into each workspace separately while generating the key for that workspace.
- Create ~/.claude/linear-mcp/admin.env (chmod 600):
LINEAR_WORKSPACES=personal,work
LINEAR_PRIMARY_WORKSPACE=personal
LINEAR_PAT_PERSONAL=lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
LINEAR_PAT_WORK=lin_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
LINEAR_LABEL_PERSONAL=Personal
LINEAR_LABEL_WORK=WorkAliases are arbitrary — name them whatever helps you route (acme,beta, team1,team2, home,client).
chmod 600 ~/.claude/linear-mcp/admin.env- Register in Claude Code (user scope, so it loads in every project):
claude mcp add -s user linear-mcp python3 -m linear_mcp.serverOr, with pipx install:
claude mcp add -s user linear-mcp linear-mcp- Restart Claude Code. healthcheck should return ok: true per workspace.
Substrate-layer enforcement (v0.3)
Three server-side checks that protect issue quality without depending on any markdown rule file or client-side memory. Apply only to WRITE paths; reads stay unconstrained.
Canonical-key examples:
- [source: 🍄 Mycelium AI/📝 Meeting Notes/2026-05-22 - sync.md]
- [source: ⚙️ Meta/Decisions/2026-05-23-merger-public-comms.md]
- [source: linear-kickoff:sweep-myc-p1]
- [source: ~/.claude/linear-mcp/BUILDPROMPTV03.md]
Fast issue execution
linear-exec is the short path for starting real work from a Linear issue. It resolves the issue, checks blocking relations, scans same-project siblings for obvious scope overlap, infers the repo when possible, and can create the standard claude-dev-worktree branch.
Dry-run a specific issue:
linear-exec execute MYC-150 --workspace myceliumStart the work after reviewing the preflight:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Linear MCP (multi-workspace, PAT auth): common questions
- Is Linear MCP (multi-workspace, PAT auth) MCP server safe?
- Mostly: it is graded B (83/100). Read the Linear MCP (multi-workspace, PAT auth) safety report
- How do I install Linear MCP (multi-workspace, PAT auth)?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Linear MCP (multi-workspace, PAT auth) need an API key?
- Yes. The registry entry asks for
LINEAR_PAT. - Is Linear MCP (multi-workspace, PAT auth) maintained?
- The last commit was 44 days ago (2026-09-19). The latest release is v0.3.2.
- What can I use instead of Linear MCP (multi-workspace, PAT auth)?
- Servers from other publishers that do the same job: TerraVision MCP server, Notion MCP server and Ekbasis MCP server.
- How does Linear MCP (multi-workspace, PAT auth) compare with other Developer tools MCP servers?
- safety score 83/100 (higher than 65% of 1,119 Developer tools servers); tools 57 (the typical Developer tools server has 7); tools that change things 28% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Linear MCP (multi-workspace, PAT auth)
Same job from other publishers: the closest match first, then the best rated.
- TerraVisionDraw cloud architecture diagrams with official AWS, Azure and GCP icons from a prompt or Terraform.not reviewedEstablishedA
- NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.not reviewedEstablishedB
- EkbasisForesee what git commands and multi-step changes will do, as calibrated probabilitiesnot reviewedEstablishedB
- AteamBuild, validate, and deploy multi-agent AI solutions from any AI environment.not reviewedGrowingA
- OcmGuardrailed fleet ops for AI agents: multi-cluster Kubernetes via OCM with policy, approval, audit.not reviewedGrowingB