Linear

🚀 Linear MCP Server

This is a Model Context Protocol (MCP) server for interacting with Linear. The server allows AI assistants to retrieve data from Linear via the MCP standard.

🚀 Quick Start

This Linear MCP server enables seamless interaction with Linear, allowing AI assistants to access data following the MCP standard.

✨ Features

• Retrieve to - do tickets for a specified user, queryable by user ID or email address.

📦 Installation

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Create a .env file in the project root directory (based on the .env.example template):

   LINEAR_API_KEY=your_linear_api_key
   

   Obtain your Linear API key from the Linear Developer Console.

💻 Usage Examples

Development

Run the development server with hot - reloading:

npm run dev

Production

Build the TypeScript code:

npm run build

Run the built program:

npm start

Using with MCP Clients

This MCP server implements the standard MCP protocol and can be used with any MCP client. The tools provided by the server include:

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 Claude conversations.

Retrieving User To - do Tickets

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

Parameters:

• userId (optional): The user's ID.
• email (optional): The user's email address.

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
  },
  ...
]

🤝 Contribution Guidelines

Contributions are welcome! Feel free to submit pull requests.