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.
Linear MCP — wraps the Linear GraphQL API (OAuth)
ADHD-friendly tasks, notes & projects for LucidNest - 18 tools, scoped tokens, Streamable HTTP.
MCP server for Linear project management and issue tracking
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,314 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.3212 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,314 npmMIT