Skip to main content
Glama

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 โ€” vitest suite + 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 published

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

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    A 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.
    198
    24,698 npm
    147
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A 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 npm
    90
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    An 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.
    25
    1,466 npm
    MIT