linear.com
linear.com logo

Linear

Track and manage issues via Linear's project management API.

Created byApr 22, 2025

Linear MCP Server

This server provides integration with Linear's issue tracking system through MCP, allowing LLMs to interact with Linear issues.

Installation

Automatic Installation

To install the Linear MCP server for Claude Desktop automatically via Smithery:

Manual Installation

  1. Create or get a Linear API key for your team: https://linear.app/YOUR-TEAM/settings/api
  1. Add server config to Claude Desktop:

Components

Tools

  1. `linear_create_issue`: Create a new Linear issues
  1. `linear_update_issue`: Update existing issues
  1. `linear_search_issues`: Search issues with flexible filtering
  1. `linear_get_user_issues`: Get issues assigned to a user
  1. `linear_add_comment`: Add comments to issues

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

Some example prompts you can use with Claude Desktop to interact with Linear:
  1. "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
  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
  1. "Find all in progress frontend tasks" use search_issues to locate frontend-related issues with in progress task
  1. "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
  1. "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

Development

  1. Install dependencies:
  1. Configure Linear API key in .env:
  1. Build the server:
For development with auto-rebuild:

License

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.

Linear MCP Server

This server provides integration with Linear's issue tracking system through MCP, allowing LLMs to interact with Linear issues.

Installation

Automatic Installation

To install the Linear MCP server for Claude Desktop automatically via Smithery:

Manual Installation

  1. Create or get a Linear API key for your team: https://linear.app/YOUR-TEAM/settings/api
  1. Add server config to Claude Desktop:

Components

Tools

  1. `linear_create_issue`: Create a new Linear issues
  1. `linear_update_issue`: Update existing issues
  1. `linear_search_issues`: Search issues with flexible filtering
  1. `linear_get_user_issues`: Get issues assigned to a user
  1. `linear_add_comment`: Add comments to issues

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

Some example prompts you can use with Claude Desktop to interact with Linear:
  1. "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
  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
  1. "Find all in progress frontend tasks" use search_issues to locate frontend-related issues with in progress task
  1. "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
  1. "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

Development

  1. Install dependencies:
  1. Configure Linear API key in .env:
  1. Build the server:
For development with auto-rebuild:

License

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.