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

Features

• Get and search Linear issues
• Create, update, and delete issues
• Manage issue properties (labels, assignees, priority)
• Work with issue comments
• Team management operations
• Project management capabilities
• Full integration with Linear's GraphQL API

Requirements

• Node.js 18+ or Docker (for local installation)
• Linear API key

Available Tools

Issue Operations - issues

• getIssue - Get a specific issue by ID
• getIssues - Get a list of issues
• createIssue - Create a new issue
• updateIssue - Update an existing issue
• deleteIssue - Delete an issue
• createIssueBatch - Create multiple issues in a batch

Comment Operations - comments

• getComments - Get comments for an issue
• createComment - Add a comment to an issue

Label Operations - labels

• getLabels - Get all available labels
• addIssueLabel - Add a label to an issue
• removeIssueLabel - Remove a label from an issue

Team Operations - teams

• getTeamById - Get a specific team by ID
• getTeams - Get a list of teams

Project Operations - projects

• getProject - Get a specific project by ID
• getProjects - Get a list of projects
• getProjectUpdate - Get a specific project update
• getProjectUpdates - Get all project updates
• createProject - Create a new project
• createProjectUpdate - Create a project update

User Operations - users

• getUserById - Get a specific user by ID
• getUsers - Get a list of users

License

MIT