Log inSubmit server
MCP Linear logo

MCP Linear

by tacticlaunch

Connects AI assistants to Linear for issue, project, document, customer, webhook, and OAuth workflows.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Linear

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tacticlaunch-mcp-linear": {
      "command": "npx",
      "args": [
        "-y",
        "@tacticlaunch/mcp-linear"
      ],
      "env": {
        "LINEAR_API_TOKEN": "YOUR_VALUE_HERE",
        "LINEAR_OAUTH_ACCESS_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @tacticlaunch/mcp-linear

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 29d ago.

Overview

The tacticlaunch/mcp-linear MCP server exposes Linear's GraphQL API through MCP tools, resources, and prompts. It supports issue and project operations alongside documents, roadmaps, customers, webhooks, OAuth applications, templates, custom fields, and operational metadata. Configure it as a local stdio process with a Linear personal API key or an eligible OAuth access token. Reach for it when an agent needs to inspect or update Linear project-management data beyond basic issue CRUD.

Use cases

  • Create and update Linear issues from natural-language requests
  • Summarize project status from current Linear data
  • Draft weekly project updates from project state
  • Manage Linear workspace webhooks and signing secrets
  • Inspect customer needs linked to projects or issues

Key features

  • Linear GraphQL API access through MCP
  • Issue, project, cycle, milestone, and roadmap management
  • MCP resources and prompts for project workflows
  • Customer records and customer-needs operations
  • Workspace webhook and OAuth application workflows
  • Rate-limit and server-health inspection

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

19/20 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @tacticlaunch/mcp-linear (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars148Stargazers on the source repository.
npm downloads12kPackage downloads in the last 30 days.
Last commit16d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Linear works

What tacticlaunch/mcp-linear MCP server does

The tacticlaunch/mcp-linear MCP server connects MCP-compatible AI clients to Linear's GraphQL API. It covers day-to-day project-management tasks as well as administrative workflows that are not limited to creating, reading, updating, and deleting issues.

Agents can retrieve issues, teams, projects, cycles, milestones, roadmaps, customers, customer needs, and documents associated with several Linear object types. They can create and modify issues, update status and assignees, add comments, manage projects and initiatives, work with saved views and favorites, and handle templates, custom fields, and attachments.

The server also exposes operations for workspace webhooks, OAuth application setup, scoped client-credentials tokens, customer records, notifications, subscriptions, sessions, audits, integrations, rate limits, and server health. Some OAuth and secret-management operations require specific Linear credentials and explicit confirmation flags.

How it works

The tacticlaunch/mcp-linear MCP server runs locally as an MCP stdio process. An MCP client launches the mcp-linear executable and passes a Linear credential through an environment variable or command-line option. The server then translates MCP requests into Linear GraphQL API operations.

In addition to tools, it publishes MCP resources such as the current viewer, organization, teams, projects, individual issues, documents, roadmaps, milestones, and rate-limit information. Built-in prompts support project-status summaries, project-update drafts, issue triage, and document summaries.

Each process uses one Linear credential. A personal API key supports normal Linear and workspace-webhook operations, while managing child OAuth applications requires an eligible OAuth application's access token. Webhook destinations must use publicly reachable HTTPS URLs.

Setup and configuration

Install the package with a package runner or configure it directly in an MCP client's settings. A manual stdio configuration uses npx with the @tacticlaunch/mcp-linear package and supplies LINEAR_API_TOKEN in the environment.

The alternative OAuth environment variable is LINEAR_OAUTH_ACCESS_TOKEN. Command-line options --token and --oauth-token can be used instead, and explicit command-line credentials take precedence. When both environment credential types are present, OAuth authentication is selected.

It provides configuration locations for Cursor and Claude Desktop, among other MCP-aware clients.

Tools and capabilities

The tacticlaunch/mcp-linear MCP server supports:

  • Issue creation, updates, status changes, assignment, and comments.
  • Project, initiative, milestone, roadmap, cycle, document, template, and saved-view workflows.
  • Customer records, customer statuses and tiers, and customer needs linked to issues or projects.
  • Workspace webhook creation, updates, and signing-secret rotation.
  • OAuth manifests, authorization URLs, child OAuth applications, and scoped client-credentials tokens.
  • MCP resources and prompts for project, issue, document, roadmap, milestone, and rate-limit data.

Limitations and notes

Personal API keys cannot call Linear's managed child-OAuth-application API. Client-credentials tokens generally expire after 30 days and do not include refresh tokens. Requesting a different scope set can revoke existing app-actor tokens, so the relevant token tool requires confirmation of secret exposure and scope-change risk.

Secrets returned during OAuth-app or webhook-secret operations are one-time values and should be moved directly into a secret manager. The server validates webhook URLs and rejects credentials in URLs along with loopback, private-network, link-local, and local-hostname destinations.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Linear

Run `npx -y @tacticlaunch/mcp-linear` through an MCP client configuration, or install the npm package globally and run `mcp-linear`.

Yes. The README provides a Claude Desktop MCP configuration using the `mcp-linear` stdio command.

It accepts a Linear personal API key by default, or an OAuth access token for eligible managed child-OAuth-application workflows.

Yes. It can create and update workspace webhooks and rotate their signing secrets. Webhook URLs must be publicly reachable HTTPS endpoints.

Related MCP servers

All in Product Management All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Linear AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tacticlaunch-mcp-linear?style=directory)](https://allmcps.com/mcp/tacticlaunch-mcp-linear)
HTML Embed
<a href="https://allmcps.com/mcp/tacticlaunch-mcp-linear"><img src="https://allmcps.com/api/badge/tacticlaunch-mcp-linear?style=directory" alt="MCP Linear on AllMCPs" /></a>