Linear MCP Server

Linear project management tasks including issue tracking and sprint filtering.

Data last scanned yesterday · Reviewed last month

107 tools★ 0TypeScript

Overview

The Linear MCP Server provides AI agents with direct access to Linear project management workflows. Through the Model Context Protocol, it allows models to search issues, list projects, and retrieve workflow states to support automated project tracking.

Our verdict

This server carries a high risk level with a security score of 10/100, largely because the last commit occurred 515 days ago and it lacks an official license. Given the lack of recent maintenance and the sensitivity of Linear API keys, this tool is recommended only for experimental or isolated environments rather than sensitive production workflows.

Supports issue creation and filtering with flexible parameters
Provides visibility into current sprint iterations and project lists
Includes a modest footprint with only seven direct dependencies

No detected license creates uncertainty regarding usage rights
Inactive development for over 500 days increases maintenance risk
Lacks verification from the official Linear platform team

Setup

Claude Desktop

{
  "mcpServers": {
    "mcp-linear-server": {
      "args": [
        "-y",
        "mcp-linear-server"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
linear_create_issue	Creates a new Linear issue with title, description, teamId, priority, and status.	medium
linear_search_issues	Search Linear issues with flexible filtering by query, team, status, assignee, priority, and limit.	low
linear_sprint_issues	Get all issues in the current sprint/iteration for a specific team.	low
linear_search_teams	Search and retrieve Linear teams by name.	low
linear_filter_sprint_issues	Filter current sprint issues by status for a specific team.	low
linear_get_workflow_states	Get all available workflow states (statuses) for a specific team.	low
linear_list_projects	Get a list of all projects available with their IDs, optionally filtered by team.	low

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What authentication is required to use this MCP server?

You must provide a Linear API key, which can be obtained from the API section of your Linear account settings.

›How do I configure the API key for Cursor usage without Docker?

You must pass the key directly in the command field of the Cursor MCP configuration using the format 'env LINEAR_API_KEY=your_key node /path/to/server/dist/server.js'.

›Can I run this server using Docker?

Yes, you can run the server via Docker Compose using the provided image, ensuring you have a .env file containing your Linear API key.

›What specific actions can the AI perform on Linear?

The server provides tools to create new issues, search for issues by various filters, retrieve sprint issues, list projects, and fetch workflow states for specific teams.

›Does the server provide any built-in monitoring or reliability features?

Yes, the server includes heartbeat monitoring for connection health, automatic reconnection logic, and API timeout protection.