@sylphx/linear-mcp/README.md

A Model Context Protocol (MCP) server for interacting with Linear issues, projects, teams, and more

# Linear MCP Server

A Model Context Protocol (MCP) server for interacting with Linear issues, projects, teams, project milestones and more.

## Features

- List, get, create, and update issues
- List, get, create, and update projects
- List and get teams
- List and get users
- List and get issue statuses
- List issue labels
- Manage project milestones (list, create, update, delete)
- List issues assigned to the current user

## Installation

```bash
npm install linear-mcp
# or
yarn add linear-mcp
# or
pnpm add linear-mcp
```

## MCP Host Configuration

Configure your MCP host (e.g., `mcp_settings.json`) to use npx:

```json
{
  "mcpServers": {
     "linear": {
      "command": "npx",
      "args": [
        "-y",
        "@sylphx/linear-mcp"
      ],
      "env": {
        "LINEAR_API_KEY": ""
      }
    }
  }
}
```
## Available Tools

### Issues

- `list_issues`: List issues in the user's Linear workspace. Supports filtering by `projectMilestoneId`.
    - **Key Inputs:** `query` (optional string), `teamId` (optional string), `stateId` (optional string), `assigneeId` (optional string), `projectMilestoneId` (optional string), `includeArchived` (boolean, default: true), `limit` (number, default: 50).
    - **Output:** Returns a list of issue objects with detailed information including `state`, `assignee`, and `projectMilestone` (if associated).
- `get_issue`: Retrieve a Linear issue's details by ID, including attachments and `projectMilestone` information.
    - **Key Inputs:** `id` (string).
    - **Output:** Returns a single issue object with its relations, including detailed `projectMilestone` information if associated.
- `create_issue`: Create a new Linear issue. Can optionally associate with a `projectMilestoneId`.
    - **Key Inputs:** `title` (string), `teamId` (string), `description` (optional string), `priority` (optional number), `projectId` (optional string), `stateId` (optional string), `assigneeId` (optional string), `labelIds` (optional array of strings), `dueDate` (optional string), `projectMilestoneId` (optional string).
    - **Output:** Returns a simplified issue object for the created issue, including `projectMilestone` information if associated.
- `update_issue`: Update an existing Linear issue. Can associate/disassociate with a `projectMilestoneId` (string or null).
    - **Key Inputs:** `id` (string), `title` (optional string), `description` (optional string), `priority` (optional number), `projectId` (optional string), `stateId` (optional string), `assigneeId` (optional string), `labelIds` (optional array of strings), `dueDate` (optional string), `projectMilestoneId` (optional string or null).
    - **Output:** Returns a simplified issue object for the updated issue, including `projectMilestone` information if associated.
- `list_comments`: Retrieve comments for a Linear issue by ID.
- `create_comment`: Create a comment on a Linear issue by ID.
- `get_issue_git_branch_name`: Retrieve the branch name for a Linear issue by ID.

### Projects

- `list_projects`: List projects in the user's Linear workspace.
- `get_project`: Retrieve details of a specific project in Linear.
- `create_project`: Create a new project in Linear.
- `update_project`: Update an existing Linear project.

### Project Milestones
- `list_project_milestones`: List all project milestones for a given project.
    - **Key Inputs:** `projectId` (string).
    - **Output:** Returns a list of project milestone objects.
- `create_project_milestone`: Create a new project milestone.
    - **Key Inputs:** `projectId` (string), `name` (string), `description` (optional string), `targetDate` (optional ISO date string).
    - **Output:** Returns the created project milestone object.
- `update_project_milestone`: Update an existing project milestone.
    - **Key Inputs:** `milestoneId` (string), `name` (optional string), `description` (optional string), `targetDate` (optional ISO date string).
    - **Output:** Returns the updated project milestone object.
- `delete_project_milestone`: Delete a project milestone.
    - **Key Inputs:** `milestoneId` (string).
    - **Output:** Returns a confirmation of deletion.

### Teams

- `list_teams`: List teams in the user's Linear workspace.
- `get_team`: Retrieve details of a specific Linear team.

### Users

- `list_users`: Retrieve users in the Linear workspace.
- `get_user`: Retrieve details of a specific Linear user.

### Issue Statuses

- `list_issue_statuses`: List available issues statuses in a Linear team.
- `get_issue_status`: Retrieve details of a specific issue status in Linear by name or ID.

### Labels

- `list_issue_labels`: List available issue labels in a Linear team.

### My Issues

- `list_my_issues`: List issues assigned to the current user.

## License

ISC