Labsco
gerbal logo

Linear MCP Server

from gerbal

A server for interacting with the Linear project management tool using the Linear API.

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

Linear MCP Server

smithery badge

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:
npm install
  1. Configure Linear API key in .env:
LINEAR_API_KEY=your_api_key_here
  1. Build the server:
npm run build

For development with auto-rebuild:

npm run watch