Linear MCP Server

Enables Claude to interact with the Linear API for managing teams, issues, projects, and cycles.

Local serverstdioTypeScript 2

What is the Linear MCP server?

Connect Linear to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Enables Claude to interact with the Linear API for managing teams, issues, projects, and cycles. The linear mcp server is what makes that connection.

What the server does

This is a Model Context Protocol (MCP) server for Linear, allowing Claude to interact with Linear's API to manage teams, issues, projects, and cycles.

  • linear_get_teams — Get all teams with their states and labels
  • linear_search_issues — Search for issues with filtering and pagination
  • linear_get_cycles — Get all cycles for a team
  • linear_get_projects — Get all projects
  • linear_create_issue — Create a new issue
  • linear_update_issue — Update an existing issue

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Credentials and setup notes

Configuration is passed through the environment: LINEAR_CLIENT_ID, LINEAR_CLIENT_SECRET, LINEAR_REDIRECT_URI, LINEAR_REFRESH_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by cpropster; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

How to install the Linear MCP server

{
  "mcpServers": {
    "github.com/cpropster/linear-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/linear-mcp-server/build/index.js"
      ],
      "env": {
        "LINEAR_CLIENT_ID": "your-client-id",
        "LINEAR_CLIENT_SECRET": "your-client-secret",
        "LINEAR_REDIRECT_URI": "http://localhost:3000/callback",
        "LINEAR_REFRESH_TOKEN": "your-refresh-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
LINEAR_CLIENT_IDConfiguration value read at startup.Optional
LINEAR_CLIENT_SECRETCredential the server authenticates with.Yes
LINEAR_REDIRECT_URIFilesystem location the server is allowed to use.Optional
LINEAR_REFRESH_TOKENCredential the server authenticates with.Yes

Frequently asked questions

The Linear MCP (Model Context Protocol) Server allows Claude AI to interact directly with the Linear API. This enables you to manage teams, issues, projects, and cycles within your Linear workspace using Claude.