Linear MCP Server

Integrations

  • Allows AI assistants to fetch data from Linear, specifically retrieving tickets in the 'Todo' state for users by ID or email address.

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.

-
security - not tested
F
license - not found
-
quality - not tested

A server that allows AI assistants to access and retrieve Linear ticket data through the Model Context Protocol (MCP) standard, currently focused on fetching a user's todo tickets.

  1. Current Features
    1. Installation
      1. Development
        1. Building for Production
          1. Using with MCP clients
            1. Using with Claude Code
            2. get-user-todo-tickets
          2. Contributing

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
              Last updated -
              1
              1,832
              1,497
              TypeScript
              MIT License
              • Apple
            • -
              security
              F
              license
              -
              quality
              An implementation of a Model Context Protocol server that allows Claude and other AI assistants to interact with Shortcut.com's ticket management system for searching, viewing, creating, and updating stories.
              Last updated -
              Python
              • Apple
            • -
              security
              A
              license
              -
              quality
              Model Context Protocol server for interacting with the HaloPSA API, enabling AI assistants like Claude to manage tickets, users, and assets in HaloPSA through natural language.
              Last updated -
              74
              JavaScript
              MIT License
              • Apple
              • Linux
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol (MCP) server for LeetCode that enables AI assistants to access LeetCode problems, user information, and contest data.
              Last updated -
              7
              1
              TypeScript
              MIT License

            View all related MCP servers

            ID: ku2ybzny31