Linear MCP Integration Server

@skspade

Basic information

About Linear MCP Integration Server

A repository for MCP server to connect to Linear

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",
        "linear-mcp-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?

This server connects AI models to Linear for issue tracking and project management through the Model Context Protocol (MCP). It provides tools to create, search, and update issues, manage sprints, and handle cycles.

How to use Linear MCP Integration Server?

Obtain a Linear API key from Linear settings, create a .env file with LINEAR_API_KEY, install dependencies (npm install), and start the server (npm start or npm run dev). Tools are accessed via MCP and include issue creation, search, sprint issue retrieval, team search, status updates, and cycle management.

Key features of Linear MCP Integration Server

Creates, searches, and retrieves Linear issues with filtering and pagination
Manages sprint issues and bulk updates statuses
Creates and updates cycles (sprints) with start/end dates
In-memory caching with configurable TTL and automatic cleanup
Automatic reconnection and heartbeat monitoring for connection health
Batch processing and pagination for large result sets

Use cases of Linear MCP Integration Server

An AI assistant creating and assigning issues based on user prompts
A developer querying current sprint issues during standups
A project manager bulk-updating issue statuses after a release
A team automating cycle creation and tracking from external events
An analyst searching across teams and priorities to generate reports

Frequently asked questions

What prerequisites are needed to run this server?

You need a Linear API key from your Linear account settings and a `.env` file containing `LINEAR_API_KEY`.

Does the server support pagination for large result sets?

Yes, all search tools support cursor-based pagination with configurable limits and sort options.

Can this server be deployed on Smithery.ai?

Yes, it includes a Dockerfile and `smithery.yaml` configuration for deployment on Smithery with your Linear API key.

What happens if the connection to the Linear API is lost?

The server automatically reconnects with configurable retry attempts and uses heartbeat monitoring to maintain connection health.

Comments

More Version Control MCP servers

Atlassian Data Center MCP

b1ff

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

Jira MCP

nguyenvanduocit

A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow tra

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).

GitLab

modelcontextprotocol

Model Context Protocol Servers

88.1K

Git MCP Server

cyanheads

A Git MCP server for AI agents. STDIO & Streamable HTTP.

225