Purpose
linear-mcp-server is a Model Context Protocol (MCP) server for interfacing with the Linear API. It integrates Linear's issue tracking system through MCP, enabling LLMs to interact with Linear issues.
Important note: this MCP server is now deprecated and no longer maintained. The author recommends switching to the official Linear remote MCP server (https://mcp.linear.app/sse）。
Main capabilities
This server provides the following tools:
- linear_create_issue: Create a new Linear issue. Required inputs: title (string, issue title), teamId (string, ID of the team creating the issue); optional inputs: description (string, issue description, supports markdown), priority (number, 0-4, 1=urgent, 4=low), status (string, initial status name).
- linear_update_issue: Update an existing issue. Required input: id (string, ID of the issue to update); optional inputs: title (new title), description (new description), priority (number, 0-4, new priority), status (new status name).
- linear_search_issues: Search issues with flexible filters. Optional inputs: query (text to search in title/description), teamId (filter by team), status (filter by status), assigneeId (filter by assignee), labels (array of strings, filter by labels), priority (number, filter by priority), limit (number, default 10, maximum number of results).
- linear_get_user_issues: Get issues assigned to a user. Optional inputs: userId (user ID; if omitted, the authenticated user), includeArchived (boolean, whether to include archived issues), limit (number, default 50, maximum number of results).
- linear_add_comment: Add a comment to an issue. Required inputs: issueId (string, ID of the issue to comment on), body (string, comment text, supports markdown); optional inputs: createAsUser (string, custom username), displayIconUrl (string, custom avatar URL).
This server also provides the following resources:
- linear-issue:///{issueId}: View details of a single issue
- linear-team:///{teamId}/issues: View team issues
- linear-user:///{userId}/assigned: View issues assigned to a userissues
- linear-organization:: View organization information
- linear-viewer:: View the current user context
Usage
Automatic installation: Automatically install the Linear MCP server for Claude Desktop via Smithery.
Manual installation:
- Create or obtain a Linear API key for your team:https://linear.app/YOUR-TEAM/settings/api
- Add the server configuration to Claude Desktop:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Development and build-related commands (based on the materials):
- Install dependencies
- Configure the Linear API key in .env
- Build the server
- Develop with automatic rebuilds
Use cases
The materials provide some example prompts that can be used with Claude Desktop:
- "Show me all my high-priority issues" → run 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 that are in progress
- "Give me a summary of recent updates on the issues for mobile app development" → use search_issues to find relevant issues, then use linear-issue:///{issueId} to get issue details and show recent activity and comments
- "What's the current workload for the mobile team?" → combine linear-team:///{teamId}/issues with search_issues to analyze the distribution and priority of the mobile team's issues
Limitations
This MCP server has been deprecated and is no longer maintained; the author recommends using the official Linear remote MCP server. The project uses the MIT license, allowing free use, modification, and distribution under the terms and conditions of the MIT license. Apart from the above, facts regarding fees, pricing, platform scope, actual results, etc. have not yet been provided.
