Linear MCP Integration Server

@MadeByNando

Repository

Basic information

About Linear MCP Integration Server

No overview available yet

#mcp #linear #integration #server #project-management

Linear MCP Integration Server config

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

{
  "mcpServers": {
    "MCP-linear-Server": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-linear-server",
        "."
      ]
    }
  }
}

Linear MCP Integration 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 Integration Server?

It is a Model Context Protocol (MCP) server that provides Linear integration, enabling AI models to interact with Linear for issue tracking and project management.

How to use Linear MCP Integration Server?

Obtain a Linear API key, configure it in a .env file, install dependencies (npm install), then start the server with npm start or run via Docker. For use with Cursor, add it as an MCP server in Cursor settings with the appropriate command including the API key.

Key features of Linear MCP Integration Server

Create new Linear issues with title, team, description, priority, and status.
Search existing Linear issues with flexible filters.
Retrieve all issues in the current sprint/iteration for a team.
Search and retrieve Linear teams by name.
Filter current sprint issues by status for a specific team.
Get all available workflow states (statuses) for a team.
List all projects with their IDs, optionally filtered by team.

Use cases of Linear MCP Integration Server

An AI assistant creates a bug report issue in a specific Linear team.
A developer asks the AI to find all high-priority issues assigned to them.
A manager requests a list of issues in the current sprint for a given team.
A user wants to filter sprint issues that are pending a production release.
An administrator retrieves all project IDs to use in later API calls.

Frequently asked questions

How do I get a Linear API key?

Go to Linear's settings > API section to generate an API key.

What are the main dependencies?

The server uses `@linear/sdk`, `@modelcontextprotocol/sdk`, `zod`, `dotenv`, and TypeScript.

How can I run the server with Docker?

Create a `.env` file, a `docker-compose.yml` as shown in the README, then run `docker-compose up -d`.

How do I use the server with Cursor?

In Cursor settings, add an MCP server with transport type "command" and the command `env LINEAR_API_KEY=your_linear_api_key node /path/to/server.js` (without Docker) or `docker exec -i mcp-linear-server node dist/server.js` (with Docker).

Does the server handle errors?

Yes, it includes API timeout protection, automatic reconnection attempts, detailed error logging, graceful shutdown, and heartbeat monitoring.

Comments

More Version Control MCP servers

Join Cloud

kushneryk

Join.cloud lets AI agents work together in real-time rooms. Agents join a room, exchange messages, commit files to shared storage, and optionally review each other's work — all through standard protocols (MCP and A2A).

MCP Atlassian

sooperset

MCP server for Atlassian tools (Confluence, Jira)

5.5K

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.

Integrate MCP with GitHub Copilot

skills

Learn how to use MCP Servers with GitHub Copilot

225

Atlassian Data Center MCP

b1ff

MCP servers for the Atlassian products (Bitbucket, Confluence, JIRA) of the Data Center version