Linear MCP Server

@argia-andreas

Repository

Basic information

About Linear MCP Server

A Linear MCP Server for interacting with Linear

#linear-mcp-server#mcp #linear

Linear MCP Server config

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

{
  "mcpServers": {
    "linear-mcp-server": {
      "command": "node",
      "args": [
        "dist/index.js"
      ],
      "env": {
        "LINEAR_API_KEY": ""
      }
    }
  }
}

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 (MCP) server that enables AI assistants to fetch data from Linear through the MCP standard. It currently allows retrieving a user’s todo tickets by user ID or email address.

How to use Linear MCP Server?

Clone the repository, install dependencies with npm install, create a .env file with your LINEAR_API_KEY (get one from the Linear Developer Console). Run in development with npm run dev, or build the TypeScript code (npm run build) and start with npm start. To integrate with Claude Code, run claude mcp add linear-mcp-server -- node dist/index.js. The server exposes a tool get-user-todo-tickets which accepts an optional userId or email parameter.

Key features of Linear MCP Server

Fetch a user’s “Todo” tickets by user ID or email
Seamless integration with any MCP client
Simple tool call returns ticket ID, identifier, title, URL, and priority

Use cases of Linear MCP Server

Let an AI assistant retrieve your pending Linear tasks during a conversation
Automate ticket lookups for a developer or team member based on email
Integrate Linear data into chat-based workflows without leaving the interface

Frequently asked questions

What does this server do?

It allows an AI assistant to query Linear for a user’s tickets that are in the “Todo” state, using either the user’s Linear ID or email address.

What dependencies are required?

You need Node.js and npm. A Linear API key is required, obtainable from the Linear Developer Console.

How do I set up the authentication?

Add your Linear API key to a `.env` file as `LINEAR_API_KEY=your_key_here`. Use the `.env.example` file as a template.

What transport does this server use?

The server implements the standard MCP protocol. It is designed to work with MCP clients (e.g., Claude Code) via command-line invocation (stdio-based).

Are there any current limitations?

Yes – the server only exposes one tool (`get-user-todo-tickets`). It retrieves only tickets in the “Todo” state. You must provide either `userId` or `email` (but not both).

Comments

More Version Control MCP servers

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

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.