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

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:

{
  "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