Linear MCP Server

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol implementation that integrates with Linear’s API to create, update, and manage issues, cycles, projects, users, teams, labels, workflow states, comments, and issue relations. It is designed for developers and teams using AI assistants that support MCP to interact with Linear programmatically.

How to use Linear MCP Server?

Obtain a Linear API key from Settings → API → Personal API keys. Install dependencies, build the project, then configure the server in your MCP client (e.g., Claude Desktop) using either the Node or Docker variant, setting the LINEAR_API_KEY environment variable. Tools are invoked via HTTP or MCP protocol.

Key features of Linear MCP Server

• MCP‑compliant server using the official SDK
• Seamless integration with the Linear API
• Type‑safe implementation with TypeScript and Zod schemas
• Comprehensive issue, cycle, project, and team management
• Pipeline execution for multi‑step conditional workflows
• Built‑in metrics, error handling, and extensible architecture

Use cases of Linear MCP Server

• Create and update issues in Linear from an AI assistant
• List and filter issues by team, project, label, state, priority, or assignee
• Manage cycles, projects, and workflow states programmatically
• Automate multi‑step workflows (pipelines) with conditions and data transformations
• Query user and team details along with issue comments and relations

FAQ from Linear MCP Server

What does Linear MCP Server do?

It acts as a bridge between MCP‑compatible AI assistants and the Linear project management API, allowing the assistant to perform operations like creating issues, listing teams, managing cycles, and executing pipelines.

What runtime or dependencies are required?

The server requires Node.js to build and run (TypeScript compiled to JavaScript). A Docker image is also available for containerized deployments.

Where does my data live?

All data remains in Linear’s cloud – the server only communicates with the Linear API using your personal API key. No data is stored locally beyond transient request processing.

How is authentication handled?

Authentication uses a Linear personal API key provided via the LINEAR_API_KEY environment variable. The key is sent with each API request; it should be kept secret and stored securely.

What transport and protocol does it use?

The server implements the Model Context Protocol (MCP) and exposes tools over HTTP (e.g., POST /tool/list_issues). It can be configured with MCP clients like Claude Desktop.