@brs98/linear-mcp NPM

Linear MCP Server

A Model Context Protocol (MCP) server that integrates with Linear's API, allowing AI models to interact with Linear through standardized MCP tools.

Quick Start for AI Integrations

Integration with Claude and Cursor

You can integrate this MCP server with Claude Desktop or Cursor by adding it to your configuration file:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@brs98/linear-mcp"],
      "env": {
        "LINEAR_API_KEY": "<your-linear-api-key>"
      }
    }
  }
}

To use only specific tools, modify the args field:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@brs98/linear-mcp", "--tools=issues,projects,teams"],
      "env": {
        "LINEAR_API_KEY": "<your-linear-api-key>"
      }
    }
  }
}

This configuration allows Claude and other AI assistants to interact with your Linear instance directly through the MCP server.

Docker Integration

For Docker-based usage with Claude Desktop or Cursor:

{
  "mcpServers": {
    "linear": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "LINEAR_API_KEY=<your-linear-api-key>",
        "brs98/linear-mcp:latest"
      ]
    }
  }
}

You can pass the same CLI options as with the npx version by adding them to the end of the args array:

{
  "mcpServers": {
    "linear": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "LINEAR_API_KEY=<your-linear-api-key>",
        "brs98/linear-mcp:latest",
        "--tools=issues,projects,teams"
      ]
    }
  }
}

CLI Options Reference:

Option	Description
`--tools`, `-t`	Specify which tools to include (comma-separated)
`--no-issues`	Exclude issue tools
`--no-comments`	Exclude comment tools
`--no-labels`	Exclude label tools
`--no-teams`	Exclude team tools
`--no-projects`	Exclude project tools
`--no-users`	Exclude user tools
`--issues-only`	Include only issue tools
`--comments-only`	Include only comment tools
`--labels-only`	Include only label tools
`--teams-only`	Include only team tools
`--projects-only`	Include only project tools
`--users-only`	Include only user tools
`--verbose`, `-v`	Enable verbose logging
`--help`, `-h`	Show help message