Linear MCP Server

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

Local serverstdioTypeScript 3

What is the Linear MCP server?

If you already use Linear, the linear mcp server is the piece that lets your assistant work with it directly. Enables AI agents to programmatically manage issues, projects, and teams within the Linear platform.

What the server does

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.

  • 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

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • create_issue — The create_issue tool exposed by this server
  • list_issues — The list_issues tool exposed by this server
  • update_issue — The update_issue tool exposed by this server
  • list_teams — The list_teams tool exposed by this server
  • list_projects — The list_projects tool exposed by this server
  • get_issue — The get_issue tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: LINEAR_API_KEY. 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.

  • Node.js (v16 or higher) - A Linear account with API access - Linear API key with appropriate permissions

Installation

The server ships on npm as @ibraheem4/linear-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Linear's toolset — create_issue, list_issues, update_issue and 3 more — is a fair guide to whether it matches your workflow. It is maintained by tiovikram; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

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.

Available tools

ToolWhat it does
create_issueThe create_issue tool exposed by this server.
list_issuesThe list_issues tool exposed by this server.
update_issueThe update_issue tool exposed by this server.
list_teamsThe list_teams tool exposed by this server.
list_projectsThe list_projects tool exposed by this server.
get_issueThe get_issue tool exposed by this server.

How to install the Linear MCP server

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

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

Configuration

  • Node.js (v16 or higher) - A Linear account with API access - Linear API key with appropriate permissions
VariableDescriptionRequired
LINEAR_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Linear to create issue.
  • Use Linear to list issues.
  • Use Linear to update issue.

Frequently asked questions

It's a Model Context Protocol (MCP) server that allows AI agents to interact with the Linear API programmatically. It enables tasks like creating, listing, and updating issues, and managing teams and projects within Linear.