linear-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@linear-mcp-serverList all issues with priority high in team Alpha"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
linear-mcp-server
MCP server for Linear — full CRUD for issues, projects, cycles, teams, labels, and workflow states.
Prerequisites
Node.js >= 18
Linear API key (Settings > API > Personal API keys)
Related MCP server: Linear MCP Server
Install & Build
git clone https://github.com/camillodev/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run buildConfigure in Claude Code / Cowork
Add to your MCP config (~/.claude/claude_desktop_config.json or project .mcp.json):
{
"mcpServers": {
"linear": {
"command": "node",
"args": ["/FULL/PATH/TO/linear-mcp-server/dist/index.js"],
"env": {
"LINEAR_API_KEY": "lin_api_YOUR_KEY_HERE"
}
}
}
}Available Tools (15 total)
Read (9)
Tool | Description |
| List all teams (get team IDs first) |
| List issues with filters (state, assignee, label) |
| Full issue detail by identifier or UUID |
| Full-text search across issues |
| List projects, optionally by team |
| List cycles/sprints for a team |
| List valid states for a team |
| List all issue labels |
| List workspace members |
Write (6)
Tool | Description |
| Create issue (with optional sub-issue, cycle, project) |
| Update any issue field |
| Create project with team association |
| Create cycle/sprint |
| Add comment to an issue |
Usage Examples
"List all my teams" → linear_list_teams
"Show in-progress issues for team X" → linear_list_issues(team_id, state_name="In Progress")
"Create a bug ticket" → linear_create_issue(team_id, title, priority=2)
"Move issue to sprint" → linear_update_issue(issue_id, cycle_id)
"Search for auth issues" → linear_search_issues(query="authentication")License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Search, read and create Linear issues, projects, teams and cycles.
Find and manage issues, projects, and documents in your Linear workspace.
Linear MCP — wraps the Linear GraphQL API (OAuth)
Assign Linear, Jira or GitHub issues to an AI coding agent team that plans, builds, reviews, tests.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.-
- AlicenseNot gradedqualityDmaintenanceAllows LLMs to integrate with Linear's issue tracking system, enabling them to create, update, search, and comment on issues through the Linear API.1,052 npmMIT
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with Linear's project management system through its GraphQL API, supporting issue creation and management, team operations, project setup, status updates, and commenting.3216 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Linear's issue tracking system, including creating, updating, searching issues, adding comments, and accessing resources via the Linear API.1,052 npmMIT