Skip to main content
Glama
enesjakozh

Linear MCP Server

by tiovikram
npmGitHub
JavaScript
83
3
  • 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) }

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
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.

  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

                    • Linear MCP Server

                      cosmix
                      A
                      security
                      A
                      license
                      A
                      quality
                      Provides a Model Context Protocol interface for accessing Linear's issue tracking system, enabling users to query and search issues with TypeScript type safety and robust error handling.
                      Last updated -
                      1,454
                      30
                      MIT License
                      • Apple
                      • Linux

                    • 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 -
                      236
                      6

                    • Linear MCP Server

                      vinayak-mehta
                      A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that integrates with Linear, enabling AI assistants to create, update, search, and comment on issues for project management and issue tracking.
                      Last updated -
                      6
                      Apache 2.0

                    • MCP Linear App

                      zalab-inc
                      -
                      security
                      F
                      license
                      -
                      quality
                      A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
                      Last updated -
                      9
                      • Apple
                      • Linux

                    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/tiovikram/linear-mcp'

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