mcpengine/servers/linear

Linear MCP Server

Complete Model Context Protocol server for Linear - the issue tracking and project management platform.

Features

• Issues: Full CRUD operations, search, archive, labels
• Projects: Project management and tracking
• Teams: Team organization and members
• Cycles: Sprint/cycle planning and management
• Labels: Label creation and assignment
• Milestones: Milestone tracking
• Users: User directory and profiles
• Comments: Issue comments and discussions
• Workflows: Custom workflow states
• Webhooks: Webhook management

Installation

npm install
npm run build

Configuration

1. Get your Linear API key from: https://linear.app/settings/api
2. Set the environment variable:

export LINEAR_API_KEY="your_api_key_here"

Or create a .env file:

cp .env.example .env
# Edit .env and add your API key

Usage

Run the server

npm start

Development

npm run dev    # Watch mode
npm run typecheck  # Type checking

MCP Integration

Add to your MCP settings (e.g., Claude Desktop config):

{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["/path/to/linear/dist/main.js"],
      "env": {
        "LINEAR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Issues (10 tools)

• linear_list_issues - List issues with filters
• linear_get_issue - Get issue by ID
• linear_create_issue - Create new issue
• linear_update_issue - Update issue
• linear_delete_issue - Delete issue
• linear_search_issues - Search issues
• linear_archive_issue - Archive issue
• linear_unarchive_issue - Unarchive issue
• linear_add_issue_label - Add label to issue
• linear_remove_issue_label - Remove label from issue

Projects (6 tools)

• linear_list_projects - List projects
• linear_get_project - Get project by ID
• linear_create_project - Create new project
• linear_update_project - Update project
• linear_delete_project - Delete project
• linear_archive_project - Archive project

Teams (3 tools)

• linear_list_teams - List teams
• linear_get_team - Get team by ID
• linear_get_team_members - Get team members

Cycles (6 tools)

• linear_list_cycles - List cycles
• linear_get_cycle - Get cycle by ID
• linear_create_cycle - Create new cycle
• linear_update_cycle - Update cycle
• linear_add_cycle_issue - Add issue to cycle
• linear_remove_cycle_issue - Remove issue from cycle

Labels (5 tools)

• linear_list_labels - List labels
• linear_get_label - Get label by ID
• linear_create_label - Create new label
• linear_update_label - Update label
• linear_delete_label - Delete label

Milestones (4 tools)

• linear_list_milestones - List milestones
• linear_get_milestone - Get milestone by ID
• linear_create_milestone - Create new milestone
• linear_update_milestone - Update milestone

Users (3 tools)

• linear_list_users - List users
• linear_get_user - Get user by ID
• linear_get_me - Get current user

Comments (5 tools)

• linear_list_comments - List comments on issue
• linear_get_comment - Get comment by ID
• linear_create_comment - Create new comment
• linear_update_comment - Update comment
• linear_delete_comment - Delete comment

Workflows (3 tools)

• linear_list_workflow_states - List workflow states
• linear_get_workflow_state - Get workflow state by ID
• linear_create_workflow_state - Create new workflow state

Webhooks (5 tools)

• linear_list_webhooks - List webhooks
• linear_get_webhook - Get webhook by ID
• linear_create_webhook - Create new webhook
• linear_update_webhook - Update webhook
• linear_delete_webhook - Delete webhook

UI Apps

15 interactive React apps included in src/apps/:

1. issue-tracker - Browse and manage issues
2. project-dashboard - Project overview and progress
3. team-overview - Team metrics and members
4. cycle-planner - Sprint/cycle planning
5. label-manager - Label organization
6. milestone-tracker - Milestone progress tracking
7. user-directory - Team directory
8. comment-feed - Issue discussions
9. workflow-designer - Custom workflow builder
10. webhook-manager - Webhook configuration
11. roadmap-view - Product roadmap
12. triage-inbox - Issue triage queue
13. analytics-dashboard - Metrics and insights
14. initiative-tracker - Strategic initiatives
15. backlog-grooming - Backlog prioritization

Rate Limits

Linear API has a complexity-based rate limit of 1500 points per hour. The client automatically tracks complexity from response extensions.

GraphQL API

Linear uses GraphQL exclusively. All operations are POST requests to https://api.linear.app/graphql with cursor-based pagination.

License

MIT