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:
``bash
export LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxx
`

3. Configure in your agent:
`yaml
mcpServers:
- name: linear
url: node ./mcp-servers/linear/dist/server.js
env:
LINEAR_API_KEY: ${LINEAR_API_KEY}
`

Available Tools

$3


- 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

$3

- 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

$3

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

$3

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

$3

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

$3

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

$3

- 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

`bash


Install dependencies

npm install

Build

npm run build

Test

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