Labsco
jerhadf logo

Linear MCP Server

★ 345

from jerhadf

Manage projects, issues, and teams using the Linear API.

🔥🔥✓ VerifiedAccount requiredNeeds API keys
#automation#git#project-mgmt

Linear MCP Server

npm version smithery badge

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)

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.

Components

Tools

  1. linear_create_issue: Create a new Linear issues

    • Required inputs:
      • title (string): Issue title
      • teamId (string): Team ID to create issue in
    • Optional inputs:
      • description (string): Issue description (markdown supported)
      • priority (number, 0-4): Priority level (1=urgent, 4=low)
      • status (string): Initial status name

  2. linear_update_issue: Update existing issues

    • Required inputs:
      • id (string): Issue ID to update
    • 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 in title/description
      • 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 (omit for authenticated user)
      • 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 to comment on
      • body (string): Comment text (markdown supported)
    • 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

Development

  1. Install dependencies:
Copy & paste — that's it
npm install
  1. Configure Linear API key in .env:
Copy & paste — that's it
LINEAR_API_KEY=your_api_key_here
  1. Build the server:
Copy & paste — that's it
npm run build

For development with auto-rebuild:

Copy & paste — that's it
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.