Home / MCP / Linear MCP Server

Linear MCP Server

Queries Linear data via MCP to fetch user Todo tickets by userId or email

typescript

Installation

Add the following to your MCP client configuration file.

Configuration

{
    "mcpServers": {
        "linear_mcp_http": {
            "url": "https://mcp.linear.example/mcp"
        }
    }
}

This MCP server lets you fetch Linear data through the MCP standard, enabling AI assistants to access a user’s Linear tickets and related information directly from conversations or tooling that support MCP clients.

How to use

You connect your Linear MCP server to an MCP client to access Linear data in conversations. The server exposes an endpoint that lets you retrieve a user’s tickets in the Todo state by providing either the user’s ID or their email. Use this to summarize tasks for teammates, track progress, or create context for AI-assisted planning.

To use it from an MCP client, register the Linear MCP server with your client and then call the get-user-todo-tickets tool using the appropriate user identifiers. If you provide a userId, the server returns that user’s Todo tickets; if you provide an email, it looks up the user by email and returns their Todo tickets. Ensure you supply either userId or email for successful responses.

How to install

Install prerequisites: Node.js (with npm) should be installed on your machine.
Clone the project repository to a local directory.
Install dependencies.
Create an environment file with your Linear API key. The key is obtained from the Linear Developer Console and should be placed as LINEAR_API_KEY in the .env file.

# Prerequisites
node -v
npm -v

# Step 1: Install dependencies
npm install

# Step 2: Prepare environment
# Create the .env file at the project root and set your API key
# LINEAR_API_KEY=your_linear_api_key_here

Additional setup and running notes

Development and production workflows are supported. You can run the server in development mode with hot reload, or build for production and run the compiled code.

# Development mode with hot reload
npm run dev

# Build for production
npm run build

# Run the compiled production server
npm start

Using with MCP clients

This MCP server is designed to work with MCP clients that support the standard MCP protocol. A common way to register the server with a client is to run the MCP entry point directly, so your client can discover and query the available tools.

In particular, you can register the Linear MCP server with Claude Code to access Linear tickets directly from conversations.

claude mcp add linear-mcp-server -- node dist/index.js

Get user Todo tickets tool

get-user-todo-tickets retrieves all tickets in the Todo state for a specified user. You must provide either the userId or the email of the user.

Parameters you can supply:

userId (optional): The ID of the user
email (optional): The email address of the user

Note: You must provide either userId or email to obtain results.

# Example response format
[
  {
    "id": "issue-id",
    "identifier": "PROJ-123",
    "title": "Fix login issue",
    "url": "https://linear.app/...",
    "priority": 1
  },
  ...
]

Notes on security and environment

Keep your Linear API key secure. Do not expose LINEAR_API_KEY in client-side code or public repositories. Use environments or secret management to supply the key to the MCP server at runtime.

Available tools

get-user-todo-tickets

Retrieves all Todo tickets for a specified user by providing userId or email. Returns ticket id, identifier, title, URL, and priority.