Linear

Official
linear
GitHubWebsite
1.3k stars149kUpdated 1mo ago93/100@linear/sdk@83.0.0· 1mo ago

The Linear API helps manage issues, projects, and product roadmaps.

This monorepo contains the Linear Client SDK for interacting with the Linear GraphQL API. It provides tools for planning and building products, streamlining issues, projects, and product roadmaps for modern software development.

What it does

  • Full issue, project, cycle, and team CRUD against the Linear GraphQL API
  • Comment, sub-issue, and priority management with no client-side ID juggling
  • Cycle and roadmap queries for status-update workflows
  • Server-sent events streaming for long-running queries so partial results arrive first
  • OAuth browser flow on first invocation, refresh tokens cached by the bridge
  • Works in Claude Desktop, Cursor, Claude Code, and any MCP client that supports stdio

Best for

Cycle planningIssue triageRoadmap queriesAutomated standup summariesPlanning and building productsStreamlining issuesManaging projectsProduct roadmaps
About Linear

Linear is an official MCP server categorised under productivity, official, linear, project management. This monorepo contains the Linear Client SDK for interacting with the Linear GraphQL API. It provides tools for planning and building products, streamlining issues, projects, and product roadmaps for modern software development.

How to install

Pick your MCP client from the Install panel on this page to get a one-click install link (Cursor, VS Code) or a ready-to-paste configuration for Claude Desktop, Claude Code, Gemini, Codex, Windsurf, and other MCP-compatible clients. No local setup required for remote servers.

License

Linear is released under the MIT license. This is a permissive open-source license, so you can freely use, modify, and distribute it — subject to its terms.

Comments

No comments yet

Be the first to leave a comment after using this server in production.

README

Refreshed 1mo ago

Linear logo

Linear API

The purpose-built tool for planning and building products

Streamline issues, projects, and product roadmaps
with the system for modern software development.

Linear is released under the MIT license. Build github action status. Release github action status. Schema github action status. Dependencies github action status.


⚠️ Monorepo Readme

If you are looking for documentation on the Linear SDK or Linear API, visit developers.linear.app instead.

The Linear Client uses custom GraphQL Code Generator plugins to produce a typed SDK for all operations and models exposed by the Linear production API.

Structure

This monorepo uses pnpm workspaces to manage and publish packages.

Generated code uses file prefix _generated and should never be manually updated.

Open source packages:

  • sdk - The Linear Client SDK for interacting with the Linear GraphQL API
  • import - Import tooling for uploading from other systems
  • codegen-doc - GraphQL codegen plugin to generate GraphQL fragments and documents
  • codegen-sdk - GraphQL codegen plugin to generate Typescript SDK from fragments and documents
  • codegen-test - GraphQL codegen plugin to generate a jest test for the Typescript SDK

Get Started

Make sure you have Node 18+ and Corepack enabled (corepack enable).

# install dependencies
pnpm install

# build all packages
pnpm build

# test all packages
pnpm test

# update the schema from the production API
pnpm schema

# create changeset for generating CHANGELOG.md
pnpm changeset

Plugin Flow

  1. The @linear/codegen-doc plugin is used by codegen.doc.yml to generate fragments and documents
  2. The @linear/codegen-sdk plugin is used by codegen.sdk.yml to generate the typed Linear SDK
  3. The @linear/codegen-test plugin is used by codegen.test.yml to generate a typed jest test

License


Licensed under the MIT License.

productivity
4.3k

This MCP server provides AI agents with tools to interact with the Notion API.

94/100typescript
version control
29k

The GitHub MCP Server connects AI tools to GitHub for repository and workflow ma

100/100go
file system
85k

This server provides secure file operations with configurable access controls.

99/100typescript
productivity
4.3k

This MCP server provides AI agents with tools to interact with the Notion API.

94/100typescript