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 byprojectMilestoneId.- 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, andprojectMilestone(if associated).
- Key Inputs:
get_issue: Retrieve a Linear issue's details by ID, including attachments andprojectMilestoneinformation.- Key Inputs:
id(string). - Output: Returns a single issue object with its relations, including detailed
projectMilestoneinformation if associated.
- Key Inputs:
create_issue: Create a new Linear issue. Can optionally associate with aprojectMilestoneId.- 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
projectMilestoneinformation if associated.
- Key Inputs:
update_issue: Update an existing Linear issue. Can associate/disassociate with aprojectMilestoneId(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
projectMilestoneinformation if associated.
- Key Inputs:
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.
- Key Inputs:
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.
- Key Inputs:
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.
- Key Inputs:
delete_project_milestone: Delete a project milestone.- Key Inputs:
milestoneId(string). - Output: Returns a confirmation of deletion.
- Key Inputs:
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