Skip to content
Back to search

linear-mcp-server

A server that integrates Linear's project management system with the Model Context Protocol (MCP) to allow LLMs to interact with Linear.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jerhadf--linear-mcp-server/badge.svg)](/listings/jerhadf--linear-mcp-server)

HTML

<a href="/listings/jerhadf--linear-mcp-server"><img src="/api/listings/jerhadf--linear-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Automatic Installation

To install the Linear MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/linear-mcp-server):

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

Manual Installation

1. Create or get a Linear API key for your team: [https://linear.app/YOUR-TEAM/settings/api](https://linear.app/YOUR-TEAM/settings/api)

2. Add server config to Claude Desktop: - MacOS: `~/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"
      }
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 141 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Linear MCP Server
  2. [![npm version](https://img.shields.io/npm/v/linear-mcp-server.svg)](https://www.npmjs.com/package/linear-mcp-server) [![smithery badge](https://smithery.ai/badge/linear-mcp-server)](https://smithery.ai/server/linear-mcp-server)
  3. **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)
  4. A [Model Context Protocol](https://github.com/modelcontextprotocol) server for the [Linear API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api).
  5. This server provides integration with Linear's issue tracking system through MCP, allowing LLMs to interact with Linear issues.
  6. ## Installation
  7. ### Automatic Installation
  8. To install the Linear MCP server for Claude Desktop automatically via [Smithery](https://smithery.ai/protocol/linear-mcp-server):
  9. ```bash
  10. npx @smithery/cli install linear-mcp-server --client claude
  11. ```
  12. ### Manual Installation
  13. 1. Create or get a Linear API key for your team: [https://linear.app/YOUR-TEAM/settings/api](https://linear.app/YOUR-TEAM/settings/api)
  14. 2. Add server config to Claude Desktop:
  15. - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  16. ```json
  17. {
  18. "mcpServers": {
  19. "linear": {
  20. "command": "npx",
  21. "args": [
  22. "-y",
  23. "linear-mcp-server"
  24. ],
  25. "env": {
  26. "LINEAR_API_KEY": "your_linear_api_key_here"
  27. }
  28. }
  29. }
  30. }
  31. ```
  32. ## Components
  33. ### Tools
  34. 1. **`linear_create_issue`**: Create a new Linear issues
  35. - Required inputs:
  36. - `title` (string): Issue title
  37. - `teamId` (string): Team ID to create issue in
  38. - Optional inputs:
  39. - `description` (string): Issue description (markdown supported)
  40. - `priority` (number, 0-4): Priority level (1=urgent, 4=low)
  41. - `status` (string): Initial status name
  42. 2. **`linear_update_issue`**: Update existing issues
  43. - Required inputs:
  44. - `id` (string): Issue ID to update
  45. - Optional inputs:
  46. - `title` (string): New title
  47. - `description` (string): New description
  48. - `priority` (number, 0-4): New priority
  49. - `status` (string): New status name
  50. 3. **`linear_search_issues`**: Search issues with flexible filtering
  51. - Optional inputs:
  52. - `query` (string): Text to search in title/description
  53. - `teamId` (string): Filter by team
  54. - `status` (string): Filter by status
  55. - `assigneeId` (string): Filter by assignee
  56. - `labels` (string[]): Filter by labels
  57. - `priority` (number): Filter by priority
  58. - `limit` (number, default: 10): Max results
  59. 4. **`linear_get_user_issues`**: Get issues assigned to a user
  60. - Optional inputs:
  61. - `userId` (string): User ID (omit for authenticated user)
  62. - `includeArchived` (boolean): Include archived issues
  63. - `limit` (number, default: 50): Max results
  64. 5. **`linear_add_comment`**: Add comments to issues
  65. - Required inputs:
  66. - `issueId` (string): Issue ID to comment on
  67. - `body` (string): Comment text (markdown supported)
  68. - Optional inputs:
  69. - `createAsUser` (string): Custom username
  70. - `displayIconUrl` (string): Custom avatar URL
  71. ### Resources
  72. - `linear-issue:///{issueId}` - View individual issue details
  73. - `linear-team:///{teamId}/issues` - View team issues
  74. - `linear-user:///{userId}/assigned` - View user's assigned issues
  75. - `linear-organization:` - View organization info
  76. - `linear-viewer:` - View current user context
  77. ## Usage examples
  78. Some example prompts you can use with Claude Desktop to interact with Linear:
  79. 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
  80. 2. "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
  81. 3. "Find all in progress frontend tasks" → use `search_issues` to locate frontend-related issues with in progress task
  82. 4. "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
  83. 5. "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
  84. ## Development
  85. 1. Install dependencies:
  86. ```bash
  87. npm install
  88. ```
  89. 1. Configure Linear API key in `.env`:
  90. ```bash
  91. LINEAR_API_KEY=your_api_key_here
  92. ```
  93. 1. Build the server:
  94. ```bash
  95. npm run build
  96. ```
  97. For development with auto-rebuild:
  98. ```bash
  99. npm run watch
  100. ```
  101. ## License
  102. 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.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.