Linear MCP Server

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.

Installation

Automatic Installation

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

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

Manual Installation

1. Create or get a Linear personal API key: https://linear.app/settings/account/security

2. Add server config to Claude Desktop:

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

Components

Tools

User-Related Tools

1. `linear_get_viewer`: Get information about the authenticated user

2. `linear_get_user_issues`: Get issues assigned to a user

3. `linear_get_user_teams`: Get teams associated with a user

4. `linear_get_user_projects`: Get projects associated with a user

Team-Related Tools

5. `linear_get_teams`: Get teams in the organization

6. `linear_get_team`: Get details about a specific team

7. `linear_get_team_issues`: Get issues for a specific team

Project-Related Tools

8. `linear_get_projects`: Get projects in the organization

9. `linear_get_project`: Get details about a specific project

10. `linear_get_project_issues`: Get issues for a specific project

Issue-Related Tools

11. `linear_create_issue`: Create a new Linear issue

12. `linear_update_issue`: Update existing issues

13. `linear_search_issues`: Search issues with flexible filtering

14. `linear_add_comment`: Add comments to issues

Label Management Tools

15. `linear_get_labels`: Get labels in the organization

16. `linear_create_label`: Create a new label

17. `linear_update_label`: Update an existing label

Attachment Management Tools

18. `linear_add_attachment`: Add an attachment to an issue

19. `linear_get_attachments`: Get attachments for an issue

Issue Relationship Tools

20. `linear_link_issues`: Create a relationship between issues

21. `linear_get_issue_relations`: Get relationships for an issue

Milestone Management Tools

22. `linear_get_milestones`: Get milestones for a project

23. `linear_create_milestone`: Create a new milestone

24. `linear_update_milestone`: Update an existing milestone

Resources

• `linear-issue:///{issueId}`: View individual issue details

• `linear-team:///{teamId}`: View team details

• `linear-team:///{teamId}/issues`: View team issues

• `linear-project:///{projectId}`: View project details

• `linear-project:///{projectId}/issues`: View project issues

• `linear-project:///{projectId}/milestones`: View project milestones

• `linear-user:///{userId}/assigned`: View user's assigned issues

• `linear-organization:`: View organization info

• `linear-viewer:`: View current user context

• `linear-viewer:///teams`: View teams for the authenticated user

• `linear-viewer:///projects`: View projects for the authenticated user

• `linear-viewer:///assigned`: View issues assigned to the authenticated user

• `linear-label:///{labelId}`: View label details

Usage examples

Here are example prompts you can use with Claude Desktop to interact with Linear:

Issue Management

• "Create a new bug report for the authentication system" → use `linear_create_issue` to create a new issue with appropriate details

• "Update the priority of ticket FRONT-123 to urgent" → use `linear_update_issue` to modify the priority of an existing issue

• "Add a comment to the login page bug explaining the root cause" → use `linear_add_comment` to add information to an existing issue

Finding and Filtering Issues

• "Show me all my high-priority issues" → use `linear_get_user_issues` or `linear-viewer:///assigned` to find issues assigned to you with high priority

• "Find all in-progress frontend tasks" → use `linear_search_issues` to locate frontend-related issues with "in progress" status

• "What issues are currently assigned to Sarah?" → use `linear_get_user_issues` with Sarah's ID to see her assignments

Team and Project Management

• "What teams am I a member of?" → use `linear_get_user_teams` or `linear-viewer:///teams` to list all teams the authenticated user belongs to

• "Show me the projects I'm leading or contributing to" → use `linear_get_user_projects` or `linear-viewer:///projects` to get all projects associated with the current user

• "What's the current progress on the mobile app project?" → use `linear_get_project` to get detailed information about the project including progress

• "List all the active projects for the Frontend team" → combine `linear_get_team` to find the team ID and `linear_get_projects` with team filter to locate active projects

Status and Workload Analysis

• "Give me a summary of recent updates on the billing system issues" → use `linear_search_issues` to identify the relevant issues, then `linear-issue:///{issueId}` to fetch the issue details

• "What's the current workload for the mobile team?" → use `linear-team:///{teamId}/issues` or `linear_get_team_issues` to analyze issue distribution across the team

• "Show me my role and responsibilities in the organization" → use `linear_get_viewer` and `linear-viewer:///teams` to analyze team memberships and roles

Label and Categorization

• "Create a 'security' label for high-priority security issues" → use `linear_create_label` to create a new label with appropriate settings

• "What labels are available in the Frontend team?" → use `linear_get_labels` with the Frontend team ID to see available categorizations

• "Apply the 'needs-documentation' label to all API issues" → use `linear_search_issues` to find API-related issues, then update each with `linear_update_issue`

Milestone Management

• "Create a milestone for the beta release" → use `linear_create_milestone` to set up a project milestone with a target date

• "What milestones are upcoming in the mobile app project?" → use `linear_get_milestones` with the project ID to view planned delivery points

• "Update the status of the API v2 milestone to completed" → use `linear_update_milestone` to change milestone status

Issue Relationships

• "Mark issue FRONT-123 as blocking API-456" → use `linear_link_issues` to create a blocking relationship between issues

• "What issues are being blocked by this bug?" → use `linear_get_issue_relations` to find dependencies

• "Show me all issues related to the authentication system" → use `linear_search_issues` with appropriate filters, then explore relationships with `linear_get_issue_relations`

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

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.