MCP.Market

Linear MCP (multi-workspace, PAT auth) MCP server

by adelaidasofia·io.github.adelaidasofia/linear-mcp·v0.3.2·1 stars

Multi-workspace Linear MCP — PAT auth, 57 tools + 3 prompts, substrate enforcement, drop-in.

B83/100grade B
What users say
No reviews yet
Be the first
Safety scan
B83/100

full report

Adoption
Growing

1 stars25 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • archive_notification

    Archive a notification (removes from inbox; reversible).

  • attachments_for_url

    Reverse 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_issues

    Apply the same update to multiple issues in one round-trip.

  • create_agent_session_on_commentwrite action
  • create_agent_session_on_issuewrite action

    Open an agent session attached to an issue.

  • create_issue_labelwrite action

    Create a new issue label.

  • create_issue_relationwrite action

    Create a relation between two issues.

  • create_webhookwrite action

    Create a webhook subscription.

  • delete_attachmentwrite action

    Delete an attachment. Destructive — uses draft+confirm.

  • delete_issue_relationwrite action

    Delete an issue relation by ID. Non-destructive (no cascade).

  • delete_webhookwrite action

    Delete a webhook. Destructive — uses draft+confirm.

  • get_agent_session

    Get an agent session by UUID.

  • get_attachment

    Get one attachment by UUID.

  • get_document

    Get a document by UUID.

  • get_initiative

    Get an initiative by UUID.

  • get_issue

    Get a single issue.

  • get_issue_status

    Return the current workflow state for one issue (id or identifier).

  • get_milestone

    Get a project milestone by UUID.

  • get_notification

    Get one notification by UUID.

  • get_project

    Get a Linear project by UUID.

  • get_team

    Get a Linear team by its UUID. Includes workflow states inline.

  • get_user

    Get a Linear user by ID. Pass `me` to look up the PAT owner.

  • get_webhook

    Get a webhook by UUID.

  • healthcheck

    Verify PAT validity for each workspace + report draft store + audit log path.

  • link_url_to_issue

    Attach an arbitrary URL to an issue.

  • list_agent_sessions

    List agent sessions. `issue_id` scopes to one issue.

  • list_attachments

    List attachments on one issue.

  • list_comments

    List comments. Scope by `issue_id` or `project_id`.

  • list_cycles

    List cycles, optionally scoped to one team.

  • list_documents

    List documents in the workspace.

  • list_initiatives

    List initiatives in the workspace.

  • list_issue_labels

    List issue labels. `team_id` scopes to one team; omit for org-wide.

  • list_issue_relations

    List issue relations. `issue_id` filters to relations involving one issue.

  • list_issue_statuses

    List workflow states (issue statuses) per team.

  • list_issues

    List issues with common filters.

  • list_milestones

    List project milestones. `project_id` scopes to one project.

  • list_notifications

    List notifications in the viewer's inbox.

  • list_projects

    List projects.

  • list_teams

    List teams in a Linear workspace.

  • list_users

    List users in a Linear workspace.

  • list_webhooks

    List webhooks configured for the workspace.

  • list_workspaces

    List configured Linear workspaces with PAT prefix + primary status.

  • mark_all_notifications_read

    Mark every notification in the inbox as read.

  • mark_notification_read

    Mark a notification read (or unread by passing `read=False`).

  • notifications_unread_count

    Return the count of unread notifications in the inbox.

  • save_commentwrite action

    Create or update a comment.

  • save_documentwrite action

    Create or update a document.

  • save_initiativewrite action

    Create or update an initiative.

  • save_issuewrite action

    Create or update an issue.

  • save_milestonewrite action

    Create or update a project milestone.

  • save_projectwrite action

    Create or update a Linear project.

  • save_status_updatewrite action

    Post a status update against a project.

  • search_documents

    Full-text search across workspace documents (NOT Linear's dev docs).

  • search_issues

    Full-text search across issues in the workspace.

  • search_projects

    Full-text search across projects in the workspace.

  • semantic_search

    Semantic search across the entire workspace.

  • update_webhookwrite action

    Update an existing webhook by UUID.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • 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
Overall 83/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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:

  1. The OAuth flow is brittle across MCP client session boundaries — auth state expires when a session resumes mid-flow.
  2. The localhost callback fails in some setups, forcing fragile paste-back flows.
  3. 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-mcp

From 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

  1. Generate one Personal API Key per workspace at . You must be logged into each workspace separately while generating the key for that workspace.
  1. 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=Work

Aliases are arbitrary — name them whatever helps you route (acme,beta, team1,team2, home,client).

chmod 600 ~/.claude/linear-mcp/admin.env
  1. Register in Claude Code (user scope, so it loads in every project):
claude mcp add -s user linear-mcp python3 -m linear_mcp.server

Or, with pipx install:

claude mcp add -s user linear-mcp linear-mcp
  1. 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 mycelium

Start 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.

  • TerraVision
    Draw cloud architecture diagrams with official AWS, Azure and GCP icons from a prompt or Terraform.
    A
  • Notion
    Token-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
    B
  • Ekbasis
    Foresee what git commands and multi-step changes will do, as calibrated probabilities
    B
  • Ateam
    Build, validate, and deploy multi-agent AI solutions from any AI environment.
    A
  • Ocm
    Guardrailed fleet ops for AI agents: multi-cluster Kubernetes via OCM with policy, approval, audit.
    B

More from adelaidasofia →