linear-mcp-server

linear-mcp-server

0
communicationdeveloper_tools

The Linear MCP Server facilitates interaction with Linear through the Model Context Protocol, enabling AI assistants to fetch and manage tasks efficiently. It's designed for seamless integration with MCP clients, including Claude Code, enhancing productivity by allowing access to user-specific Linear tickets.

Linear MCP Server

A Model Context Protocol (MCP) server for interacting with Linear. This server allows AI assistants to fetch data from Linear through the MCP standard.

Current Features

  • Get a user's todo tickets by user ID or email address

Installation

  1. Clone this repository
  2. Install dependencies: 
    npm install
  3. Create a .env file at the root of the project (copy from .env.example): 
    LINEAR_API_KEY=your_linear_api_key_here
    Get your Linear API key from the Linear Developer Console

Development

Run the development server (with hot reload):

npm run dev

Building for Production

Build the TypeScript code:

npm run build

Run the compiled code:

npm start

Using with MCP clients

This MCP server implements the standard MCP protocol and can be used with any MCP client. The server exposes the following tools:

Using with Claude Code

To use this MCP server with Claude Code, run the following command:

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

This registers the Linear MCP server with Claude Code, allowing you to access Linear tickets directly from your Claude conversations.

get-user-todo-tickets

Gets all tickets in the "Todo" state for a specified user.

Parameters:

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

Note: You must provide either userId or email.

Example response:

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

Contributing

Contributions are welcome! Feel free to submit a pull request.