MCP.so
Sign In

Linear MCP Server

@argia-andreas

About Linear MCP Server

A Linear MCP Server for interacting with Linear

Basic information

Category

Version Control

Runtime

node

Transports

stdio

Publisher

argia-andreas

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": ""
      }
    }
  }
}

Tools

No tools detected

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

FAQ from Linear MCP Server

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