Linear Context Server

Linear MCP Server

A Model Context Protocol server for Linear.

Tools

> [!IMPORTANT] > * means required.

create_issue

Create a new Linear issue.

Parameters

• title (string*): Title of the issue
• description (string): Description of the issue
• assignee (string): Set to 'me' to assign to self

create_comment

Create a new comment on an existing Linear issue.

Parameters

• id (string*): ID of the existing Linear issue.
• body (string*): Body of the comment

list_issues

List all Linear issues assigned to me.

Parameters

N/A

list_teams

List all Linear teams I have access to.

Parameters

N/A

Examples

Listing issues assigned to me

Creating an issue

How to use

To use with Claude Desktop, add the server config.

Linear API key

You can create a Personal API Key at https://linear.app/your-team-name/settings/account/security. Remember to replace your-team-name with the correct value.

Automatic

> [!TIP] > .env files are supported.

LINEAR_API_KEY= npm run configure [--force] [--name=]

Manual

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

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

{
  "mcpServers": {
    "linear-context-server": {
      "command": "node",
      "args": [
        "//linear-context-server/build/server.js"
      ],
      "env": {
        "LINEAR_API_KEY": 
      }
    }
  }
}

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jesse-c
• Source: jesse-c/linear-context-server
• License: MIT

Install and usage instructions live in the source repository linked above.