Skip to main content
Glama
deenesjakoruzh

Linear MCP Server

by ibraheem4
npmGitHub
JavaScript
MIT License
83
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Linear MCP Server

Note: This is a custom implementation. For the official Cline Linear MCP server, see cline/linear-mcp.

A Model Context Protocol (MCP) server that provides tools for interacting with Linear's API, enabling AI agents to manage issues, projects, and teams programmatically through the Linear platform.

Features

  • Issue Management

    • Create new issues with customizable properties (title, description, team, assignee, priority, labels)

    • List issues with flexible filtering options (team, assignee, status)

    • Update existing issues (title, description, status, assignee, priority)

  • Team Management

    • List all teams in the workspace

    • Access team details including ID, name, key, and description

  • Project Management

    • List all projects with optional team filtering

    • View project details including name, description, state, and associated teams

Prerequisites

  • Node.js (v16 or higher)

  • A Linear account with API access

  • Linear API key with appropriate permissions

Quick Start

  1. Get your Linear API key from Linear's Developer Settings

  2. Run with your API key:

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

Or set it in your environment:

export LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

Development Setup

  1. Clone the repository:

git clone [repository-url] cd linear-mcp

  1. Install dependencies:

npm install

  1. Build the project:

npm run build

Running with Inspector

For local development and debugging, you can use the MCP Inspector:

  1. Install supergateway:

npm install -g supergateway

  1. Use the included run.sh script:

chmod +x run.sh LINEAR_API_KEY=your-api-key ./run.sh

  1. Access the Inspector:

    • Open localhost:1337 in your browser

    • The Inspector connects via Server-Sent Events (SSE)

    • Test and debug tool calls through the Inspector interface

Configuration

Configure the MCP server in your settings file based on your client:

For Claude Desktop

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "linear-mcp": { "command": "node", "args": ["/path/to/linear-mcp/build/index.js"], "env": { "LINEAR_API_KEY": "your-api-key-here" }, "disabled": false, "alwaysAllow": [] } } }

For VS Code Extension (Cline)

Location: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{ "mcpServers": { "linear-mcp": { "command": "node", "args": ["/path/to/linear-mcp/build/index.js"], "env": { "LINEAR_API_KEY": "your-api-key-here" }, "disabled": false, "alwaysAllow": [] } } }

For Cursor (cursor.sh)

For Cursor, the server must be run with the full path:

node /Users/ibraheem/Projects/linear-mcp/build/index.js

Available Tools

create_issue

Creates a new issue in Linear.

{ title: string; // Required: Issue title description?: string; // Optional: Issue description (markdown supported) teamId: string; // Required: Team ID assigneeId?: string; // Optional: Assignee user ID priority?: number; // Optional: Priority (0-4) labels?: string[]; // Optional: Label IDs to apply }

list_issues

Lists issues with optional filters.

{ teamId?: string; // Optional: Filter by team ID assigneeId?: string; // Optional: Filter by assignee ID status?: string; // Optional: Filter by status first?: number; // Optional: Number of issues to return (default: 50) }

update_issue

Updates an existing issue.

{ issueId: string; // Required: Issue ID title?: string; // Optional: New title description?: string; // Optional: New description status?: string; // Optional: New status assigneeId?: string; // Optional: New assignee ID priority?: number; // Optional: New priority (0-4) labels?: string[]; // Optional: Label IDs to apply to the issue }

list_teams

Lists all teams in the workspace. No parameters required.

list_projects

Lists all projects with optional filtering.

{ teamId?: string; // Optional: Filter by team ID first?: number; // Optional: Number of projects to return (default: 50) }

get_issue

Gets detailed information about a specific issue.

{ issueId: string; // Required: Issue ID }

Development

For development with auto-rebuild:

npm run watch

Error Handling

The server includes comprehensive error handling for:

  • Invalid API keys

  • Missing required parameters

  • Linear API errors

  • Invalid tool requests

All errors are properly formatted and returned with descriptive messages.

Technical Details

Built with:

  • TypeScript

  • Linear SDK (@linear/sdk v37.0.0)

  • MCP SDK (@modelcontextprotocol/sdk v0.6.0)

The server uses stdio for communication and implements the Model Context Protocol for seamless integration with AI agents.

License

MIT

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI agents to manage issues, projects, and teams on the Linear platform programmatically.

  1. Features
    1. Prerequisites
      1. Quick Start
        1. Development Setup
          1. Running with Inspector
            1. Configuration
              1. For Claude Desktop
              2. For VS Code Extension (Cline)
              3. For Cursor (cursor.sh)
            2. Available Tools
              1. create_issue
              2. list_issues
              3. update_issue
              4. list_teams
              5. list_projects
              6. get_issue
            3. Development
              1. Error Handling
                1. Technical Details
                  1. License

                    Related Resources

                    Related MCP Servers

                    • Crew AI MCP Server

                      MatthewLaw1
                      -
                      security
                      F
                      license
                      -
                      quality
                      Enables AI agent and task management using the CrewAI framework, allowing users to create and run agents and tasks in an automated workflow environment.
                      Last updated -
                      0
                      3

                    • Linear MCP Server

                      samcfinan
                      -
                      security
                      F
                      license
                      -
                      quality
                      Facilitates project management with the Linear API via the Model Context Protocol, allowing users to manage initiatives, projects, issues, and their relationships through features like creation, viewing, updating, and prioritization.
                      Last updated -
                      237
                      6

                    • Linear MCP Server

                      tiovikram
                      A
                      security
                      F
                      license
                      A
                      quality
                      Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
                      Last updated -
                      83
                      3
                      • Apple

                    • Linear MCP Integration Server

                      MadeByNando
                      -
                      security
                      F
                      license
                      -
                      quality
                      Enables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.
                      Last updated -

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/ibraheem4/linear-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server