Linear MCP Server

Note: This is a custom implementation. For the official Cline Linear MCP server, see cline/linear-mcp.

A Model Context Protocol (MCP) server that provides tools for interacting with Linear’s API, enabling AI agents to manage issues, projects, teams, and more programmatically.

Installation

Prerequisites

• Node.js (v16 or higher)
• A Linear account with API access
• Linear API key with appropriate permissions (get from Linear’s Developer Settings)

Usage

Quick Start

You need to provide your Linear API key to the server.

Option 1: Command Line Argument

LINEAR_API_KEY=your-api-key npx @gmclend/linear-mcp

Option 2: Environment Variable

export LINEAR_API_KEY=your-api-key
# Then run the server
npx @gmclend/linear-mcp

Client Configuration

Configure your MCP client (e.g., in its settings file) to connect to this server:

{
  "mcpServers": {
    "linear-mcp": {
      "command": "npx",
      "args": ["-y", "@gmclend/linear-mcp"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here",
        // Optional: Enable read-only mode (see below)
        "LINEAR_MCP_READ_ONLY": "false" 
      }
    }
  }
}

Read-Only Mode

Run the server in read-only mode to prevent accidental modifications and limit the available tools (useful in restricted environments). Set the LINEAR_MCP_READ_ONLY environment variable:

LINEAR_MCP_READ_ONLY=true LINEAR_API_KEY=your-api-key npx @gmclend/linear-mcp

Features

This server provides comprehensive tools for managing various Linear entities:

• Issue Management: Create, list (with filters), update, and search issues.
• Comment Management: Create, view, update, and delete comments on issues.
• Label Management: List, create, and update team labels.
• Team Management: List teams and view team details.
• Project Management: List projects (with filters) and view project details.
• Cycle Management: List, create, and update team cycles.
• Document Management: List, create, and update project documents.
• User Management: List users, get user details, and get info about the authenticated user.
• Roadmap/Initiative Management: List roadmaps/initiatives and get details.

Available Tools

All tools are defined in src/tools/definitions.ts.

Read-Only Tools

(Available in both standard and read-only modes)

• list_issues: List issues with optional filters (team, assignee, status, priority, etc.).
• search_issues: Search issues using query text.
• get_issue: Get detailed information about a specific issue.
• get_comment: Get a specific comment.
• list_labels: List all labels in a team.
• get_label: Get label details.
• list_teams: List all teams in the workspace.
• get_team: Get team details.