Manage Linear issues, projects, and cycles with AI
The official Linear MCP Server lets your AI assistant manage issues, projects, and cycles in Linear. Create issues, update status, search across projects, and triage backlogs through natural language.
Built and maintained by Linear, this server connects to your Linear workspace using an API key. It supports full issue lifecycle management including creation, updates, comments, and status transitions.
Perfect for engineering teams that use Linear for project management and want AI-assisted issue triage, sprint planning, and workflow automation.
Valid MCP server (2 strong, 4 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
3 files analyzed · 3 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Add this to your MCP configuration file:
{
"mcpServers": {
"linear": {
"env": {
"LINEAR_API_KEY": "<your-api-key>"
},
"args": [
"-y",
"@linear/mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
IMPORTANT NOTE: This MCP Server is now deprecated and is no longer being maintained. I recommend you use the official Linear remote MCP server here: https://linear.app/changelog/2025-05-01-mcp (https://mcp.linear.app/sse)
A Model Context Protocol server for the Linear API.
This server provides integration with Linear's issue tracking system through MCP, allowing LLMs to interact with Linear issues.
To install the Linear MCP server for Claude Desktop automatically via Smithery:
npx @smithery/cli install linear-mcp-server --client claude
Create or get a Linear API key for your team: https://linear.app/YOUR-TEAM/settings/api
Add server config to Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"linear": {
"command": "npx",
"args": [
"-y",
"linear-mcp-server"
],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}
linear_create_issue: Create a new Linear issues
title (string): Issue titleteamId (string): Team ID to create issue indescription (string): Issue description (markdown supported)priority (number, 0-4): Priority level (1=urgent, 4=low)status (string): Initial status namelinear_update_issue: Update existing issues
id (string): Issue ID to updatetitle (string): New titledescription (string): New descriptionpriority (number, 0-4): New prioritystatus (string): New status namelinear_search_issues: Search issues with flexible filtering
query (string): Text to search in title/descriptionteamId (string): Filter by teamstatus (string): Filter by statusassigneeId (string): Filter by assigneelabels (string[]): Filter by labelspriority (number): Filter by prioritylimit (number, default: 10): Max resultslinear_get_user_issues: Get issues assigned to a user
userId (string): User ID (omit for authenticated user)includeArchived (boolean): Include archived issueslimit (number, default: 50): Max resultslinear_add_comment: Add comments to issues
issueId (string): Issue ID to comment onbody (string): Comment text (markdown supported)createAsUser (string): Custom usernamedisplayIconUrl (string): Custom avatar URLlinear-issue:///{issueId} - View individual issue detailslinear-team:///{teamId}/issues - View team issueslinear-user:///{userId}/assigned - View user's assigned issueslinear-organization: - View organization infolinear-viewer: - View current user contextSome example prompts you can use with Claude Desktop to interact with Linear:
"Show me all my high-priority issues" → execute the search_issues tool and/or linear-user:///{userId}/assigned to find issues assigned to you with priority 1
"Based on what I've told you about this bug already, make a bug report for the authentication system" → use create_issue to create a new high-priority issue with appropriate details and status tracking
"Find all in progress frontend tasks" → use search_issues to locate frontend-related issues with in progress task
"Give me a summary of recent updates on the issues for mobile app development" → use search_issues to identify the relevant issue(s), then linear-issue:///{issueId} fetch the issue details and show recent activity and comments
"What's the current workload for the mobile team?" → combine linear-team:///{teamId}/issues and search_issues to analyze issue distribution and priorities across the mobile team
npm install
.env:LINEAR_API_KEY=your_api_key_here
npm run build
For development with auto-rebuild:
npm run watch
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Be the first to review this server!
by Modelcontextprotocol · Productivity
Knowledge graph-based persistent memory across sessions
by Modelcontextprotocol · Productivity
Time and timezone conversion capabilities for your AI assistant
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally