ai-agent-linear-mcp-server

Linear MCP Server

MCP server for Linear.app integration, providing comprehensive access to Linear's GraphQL API through the Model Context Protocol.

Features

• Issue Management: Create, read, update, and delete issues
• Project Management: Manage projects and project relationships
• Team Operations: Access team information and team-specific issues
• User Management: List users and get user details
• Comments: Add, edit, and delete comments on issues
• Workflow States: Move issues between workflow states
• Labels: Manage issue labels
• Cycles/Sprints: Work with cycles and sprint planning

Setup

• Get your Linear API key:

  • Go to Linear Settings → API → Personal API keys
  • Create a new key with appropriate permissions
  • Copy the generated key

• Set the environment variable:

  export LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxx
  

• Configure in your agent:

  mcpServers:
    - name: linear
      url: node ./mcp-servers/linear/dist/server.js
      env:
        LINEAR_API_KEY: ${LINEAR_API_KEY}
  

Available Tools

Issue Management

• linear_list_issues - List issues with filters
• linear_get_issue - Get specific issue details
• linear_create_issue - Create new issue
• linear_update_issue - Update issue fields
• linear_delete_issue - Archive/delete issue
• linear_search_issues - Search issues by query

Project Management

• linear_list_projects - List projects
• linear_get_project - Get project details
• linear_create_project - Create new project
• linear_update_project - Update project
• linear_add_issue_to_project - Link issue to project

Team Operations

• linear_list_teams - List all teams
• linear_get_team - Get team details
• linear_list_team_issues - Get team issues

User Operations

• linear_list_users - List workspace users
• linear_get_current_user - Get authenticated user
• linear_get_user - Get user details

Comments

• linear_add_comment - Add comment to issue
• linear_list_comments - List issue comments
• linear_update_comment - Edit comment
• linear_delete_comment - Delete comment

Workflow & Labels

• linear_list_workflow_states - List states
• linear_move_issue - Change issue state
• linear_list_labels - List labels
• linear_add_label - Add label to issue

Cycles/Sprints

• linear_list_cycles - List cycles
• linear_get_current_cycle - Get active cycle
• linear_add_issue_to_cycle - Add to sprint

Rate Limits

Linear API has the following rate limits:

• API key authentication: 1,500 requests per hour per user
• OAuth app authentication: 500 requests per hour per user/app

Development

# Install dependencies
npm install

# Build
npm run build

# Test
echo '{"method": "tools/list"}' | node dist/server.js