ai-agent-linear-mcp-server

1.0.0 • Public • Published

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

  1. Get your Linear API key:

    • Go to Linear Settings → API → Personal API keys
    • Create a new key with appropriate permissions
    • Copy the generated key
  2. Set the environment variable:

    export LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxx
  3. 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

Package Sidebar

Install

npm i ai-agent-linear-mcp-server

Weekly Downloads

3

Version

1.0.0

License

MIT

Unpacked Size

71.6 kB

Total Files

12

Last publish

Collaborators

  • celp