Linear MCP Server

@kablewy

Repository

Basic information

About Linear MCP Server

Robust, production tested MCP Server for linear (API)

#mcp #mcp-server

Linear MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "linear-mcp-server-kablewy": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp/linear",
        "-f",
        "src/linear/Dockerfile",
        "."
      ]
    }
  }
}

Linear MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

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.

Comments

More Version Control MCP servers

MCP GitHub Project Manager

kunwarVivek

a mcp server to manage github project's functionality

Bitbucket Server MCP

garc33

Github

modelcontextprotocol

Model Context Protocol Servers

88.1K

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

Git

modelcontextprotocol

Model Context Protocol Servers

88.1K