📌Overview

Purpose: To facilitate integration with the Linear API for issue tracking, enabling Large Language Models (LLMs) to interact seamlessly with Linear issues.

Overview: The Linear MCP Server serves as a bridge between the Model Context Protocol (MCP) and the Linear API, allowing users to manage and interact with issues within Linear effectively. It enhances the user experience by enabling commands and tools that simplify task management.

Key Features:

• Issue Creation (linear_create_issue): Allows users to create new issues in Linear, specifying essential information like title and team while optionally adding description, priority, and status. This feature supports proper task initiation within teams.

• Issue Management (linear_update_issue): Users can update existing issues by providing the issue ID and any new details. This ensures that issue records remain current and accurate as work progresses.

• Flexible Issue Searching (linear_search_issues): This feature enables users to search for issues with various filters (e.g., status, assignee, priority), making it easy to locate specific tasks based on customized criteria.

• User-Specific Issue Retrieval (linear_get_user_issues): Users can access issues assigned to a particular user, enhancing personal task visibility and management.

• Commenting on Issues (linear_add_comment): Users can add comments to issues, fostering communication and collaboration throughout the issue resolution process.

---

Linear MCP Server

A Model Context Protocol (MCP) server for the Linear API, enabling integration with Linear's issue tracking system and allowing language models to interact with Linear issues.

Installation

Automatic Installation

To install the Linear MCP server for Claude Desktop automatically:

npx @smithery/cli install linear-mcp-server --client claude

Manual Installation

1. Create or obtain a Linear API key for your team.
2. Add server config to Claude Desktop:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Components

Tools

1. linear_create_issue: Create a new Linear issue

   • Required inputs:
     • title (string): Issue title
     • teamId (string): Team ID
   • Optional inputs:
     • description (string): Issue description
     • priority (number, 0-4): Priority level
     • status (string): Initial status name

2. linear_update_issue: Update existing issues

   • Required inputs:
     • id (string): Issue ID
   • Optional inputs:
     • title (string): New title
     • description (string): New description
     • priority (number, 0-4): New priority
     • status (string): New status name

3. linear_search_issues: Search issues with flexible filtering

   • Optional inputs:
     • query (string): Text to search
     • teamId (string): Filter by team
     • status (string): Filter by status
     • assigneeId (string): Filter by assignee
     • labels (string[]): Filter by labels
     • priority (number): Filter by priority
     • limit (number, default: 10): Max results

4. linear_get_user_issues: Get issues assigned to a user

   • Optional inputs:
     • userId (string): User ID
     • includeArchived (boolean): Include archived issues
     • limit (number, default: 50): Max results

5. linear_add_comment: Add comments to issues

   • Required inputs:
     • issueId (string): Issue ID
     • body (string): Comment text
   • Optional inputs:
     • createAsUser (string): Custom username
     • displayIconUrl (string): Custom avatar URL

Resources

• linear-issue:///{issueId}: View individual issue details
• linear-team:///{teamId}/issues: View team issues
• linear-user:///{userId}/assigned: View user's assigned issues
• linear-organization:: View organization info
• linear-viewer:: View current user context

Usage Examples

1. "Show me all my high-priority issues" → Execute search_issues to find issues assigned to you with priority 1.
2. "Make a bug report for the authentication system" → Use create_issue to create a high-priority issue.
3. "Find all in-progress frontend tasks" → Locate frontend-related issues using search_issues.
4. "Summarize recent updates on mobile app development issues" → Identify relevant issues, fetch details, and show recent activity.
5. "Analyze current workload for the mobile team" → Combine team and issue searches to assess distribution and priorities.

Development

1. Install dependencies:

npm install

2. Configure Linear API key in .env:

LINEAR_API_KEY=your_api_key_here

3. Build the server:

npm run build

For development with auto-rebuild:

npm run watch

License

Licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, see the LICENSE file in the project repository.