Use This MCP server To

Integrate Linear project data into AI workflows for real-time updates Manage and prioritize issues and projects via AI-driven interfaces Enable AI models to understand project relationships and dependencies Automate project status summaries and reporting using Linear data Facilitate holistic project management with AI assistance through Claude integration

README

Linear MCP Server

A Model Context Protocol server for the Linear API.

Intended to be more feature rich than existing Linear MCP servers and intended for holistic project management via Claude.

This is based off of https://github.com/jerhadf/linear-mcp-server with more functionality.

Features:

Initiatives
Projects
Issues
Relationships
Prioritization

Installation

Add server config to Claude Desktop.

NOTE: Claude does not work well with nvm environments. Make sure to reference the version of Node with its absolute path.

{
  "mcpServers": {
    "linear": {
      "command": "/Users/USERNAME/.nvm/versions/node/v22.13.0/bin/node",
      "args": [
        "--experimental-strip-types",
        "/absolute/path/to/repo/index.ts"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Available Tools

Project Management

create-project - Create a new Linear project
view-project - View a Linear project by ID
update-project - Update a Linear project

Initiative Management

create-initiative - Create a new Linear initiative
view-initiative - View a Linear initiative by ID
update-initiative - Update a Linear initiative

Issue Management

create-issue - Create a new Linear issue
view-issue - View a Linear issue by ID
update-issue - Update a Linear issue
search-issues - Search Linear issues

Issue Relations

create-issue-relation - Create a relation between two issues (blocks, duplicates, etc.)
view-issue-relations - View all relations for a given issue
delete-issue-relation - Delete a relation between two issues

Example

User:
Break the Implement Contact API Endpoints issue into multiple issues, one for each endpoint

Claude:
I'll break down the API endpoints issue into separate issues for each endpoint and create the appropriate relationships.


View result from create-issue from linear (local)


View result from create-issue from linear (local)


View result from create-issue from linear (local)


View result from create-issue from linear (local)


View result from create-issue from linear (local)

Now let's create the relationships between these new issues and the existing ones. First, they all depend on the TypeScript Models issue:


View result from create-issue-relation from linear (local)


View result from create-issue-relation from linear (local)


View result from create-issue-relation from linear (local)


View result from create-issue-relation from linear (local)


View result from create-issue-relation from linear (local)

I've created five separate issues for each endpoint and set up their relationships:

GET /contacts (List) - d1aae514
GET /contacts/:id (Single) - 01850d5d
POST /contacts (Create) - 2e0f2b75
PUT /contacts/:id (Update) - d22b143d
DELETE /contacts/:id (Delete) - dde30779
All of these endpoints depend on the TypeScript Models issue (2c38c6ee) being completed first.

The UI Components issue (dd214884) and Search/Filter issue (81a33a29) now should depend on the completion of these endpoint issues, particularly the GET endpoints.

Would you like me to:

Create those additional relationships with the UI Components?
Add any specific cross-dependencies between the endpoints themselves?
Break down any of these endpoint issues into more granular tasks?

linear-mcp-server FAQ

How do I install the Linear MCP Server?

Add the server configuration to Claude Desktop, ensuring Node.js is referenced with an absolute path due to nvm compatibility issues.

What environment variables are required?

You need to set the LINEAR_API_KEY environment variable with your Linear API key.

Can this server handle project prioritization?

Yes, it supports prioritization along with initiatives, projects, issues, and relationships.

Is this server compatible with other LLMs besides Claude?

While designed for Claude, it can be adapted for use with other LLMs like OpenAI's GPT-4 and Anthropic's Claude by configuring the MCP client accordingly.

Does this server support real-time updates from Linear?

It exposes Linear data in real-time context to the model, enabling up-to-date project management workflows.

What makes this server different from other Linear MCP servers?

It offers more features and holistic project management capabilities than existing Linear MCP servers, based on an enhanced fork.