linear-mcp
Provides tools for interacting with Linear's API, enabling AI agents to manage issues, projects, teams, and comments programmatically through the Linear platform.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@linear-mcpfind all high priority issues assigned to me"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
linear-mcp
A production-grade, open-source MCP server connecting Claude to Linear, plus a reference agent that completes a real multi-step task across it.
Target role this answers: Forward-Deployed Engineer โ this is the literal artifact Anthropic's FDE JD asks for: "deliver technical artifacts for customers like MCP servers."
Pillar: Integration + hardening โ a public, verifiable artifact (GitHub + npm) with engineering rigor most candidates never show.
๐๏ธ Build status: scaffolding. Project 2 of 3. Also doubles as the escalation backend for
support-copilot.
What it does
A TypeScript MCP server on @modelcontextprotocol/sdk exposing 6โ10 typed tools over the Linear API (search / get / create / update / comment, list teams / projects), wrapped in a real resilience layer.
Related MCP server: streamlinear
Architecture (planned)
Tools โ
zod-typed input + output schemas for each tool.Resilience layer โ OAuth/token handling, rate-limit handling, retries with exponential backoff, pagination, idempotency, structured recoverable errors.
Reference agent โ Claude with tool use completing a real cross-system task end to end.
Quality โ
vitestsuite + tool-use evals (right tool, right args, across N scenarios; reuses the EvalOps harness) + GitHub Actions CI.Distribution โ published to npm + listed in an MCP registry.
Tech stack
TypeScript ยท @modelcontextprotocol/sdk ยท zod ยท Vitest ยท Claude API
Install (planned)
npx linear-mcp # one-line install, once publishedDefinition of done
Public repo + npm package + registry listing, passing CI, a tool-use eval suite, and a Loom of Claude completing a live multi-step task.
Interview-ready checklist
Public GitHub repo + README with architecture diagram
npm package + MCP registry listing
Green CI + tool-use eval suite
60โ90s Loom of a live multi-step task
License
MIT โ see LICENSE.
Part of Road to First AI Role. Reuses the eval harness from EvalOps; is the escalation backend for support-copilot.
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Linear project management and issue tracking
Linear MCP โ wraps the Linear GraphQL API (OAuth)
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Search, read and create Linear issues, projects, teams and cycles.
Related MCP Servers
- AlicenseBqualityAmaintenanceA Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.19824,698 npm147MIT
- AlicenseNot gradedqualityDmaintenanceA lightweight MCP server that enables Claude to interact with Linear via a single tool with seven actions: search, get, update, comment, create, graphql, and help.479 npm90MIT
- AlicenseNot gradedqualityFmaintenanceMCP server for Linear that allows creating issues, adding comments, and listing issues and teams.5 npm4MIT
- AlicenseBqualityDmaintenanceAn MCP server that integrates with Linear's API, enabling users to manage issues, projects, teams, and comments through natural language. It supports creating, updating, deleting, and searching issues, as well as project and team management.251,466 npmMIT