MCP server for Linear.app integration, providing comprehensive access to Linear's GraphQL API through the Model Context Protocol.
- 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
-
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}
-
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
-
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
-
linear_list_teams
- List all teams -
linear_get_team
- Get team details -
linear_list_team_issues
- Get team issues
-
linear_list_users
- List workspace users -
linear_get_current_user
- Get authenticated user -
linear_get_user
- Get user details
-
linear_add_comment
- Add comment to issue -
linear_list_comments
- List issue comments -
linear_update_comment
- Edit comment -
linear_delete_comment
- Delete comment
-
linear_list_workflow_states
- List states -
linear_move_issue
- Change issue state -
linear_list_labels
- List labels -
linear_add_label
- Add label to issue
-
linear_list_cycles
- List cycles -
linear_get_current_cycle
- Get active cycle -
linear_add_issue_to_cycle
- Add to sprint
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
# Install dependencies
npm install
# Build
npm run build
# Test
echo '{"method": "tools/list"}' | node dist/server.js