linear-mcp

Tyru5/linear-mcp

3.1

If you are the rightful owner of linear-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Linear MCP Server provides tools to interact with the Linear API, allowing users to fetch tasks and their associated details.

Tools
4
Resources
0
Prompts
0

Linear MCP Server

This MCP server provides tools to interact with the Linear API, allowing you to fetch tasks and their associated details.

Setup

  1. Install dependencies:

    npm install
    
  2. Build the server:

    npm run build
    
  3. Configure your Linear API key:

    • Get your API key from Linear (Settings > API > Personal API Keys)
    • Update the MCP settings file with your API key:
      • Location: /Users/tiru5/Library/Application Support/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
      • Replace YOUR_LINEAR_API_KEY_HERE with your actual API key

Available Tools

get_tasks

Get tasks from Linear with optional filtering.

Parameters:

  • status (optional): Filter by status (e.g., "Todo", "In Progress", "Done")
  • assignee (optional): Filter by assignee name or ID
  • team (optional): Filter by team name or ID
  • limit (optional): Maximum number of tasks to return (default: 20, max: 100)

Example:

{
  "status": "In Progress",
  "assignee": "John",
  "team": "Engineering",
  "limit": 10
}

get_task_details

Get detailed information about a specific task.

Parameters:

  • taskId (required): The ID of the task to retrieve details for

Example:

{
  "taskId": "LIN-123"
}

get_teams

Get a list of teams in the Linear workspace.

Parameters: None

get_users

Get a list of users in the Linear workspace.

Parameters: None

Usage Examples

Fetching tasks assigned to a specific user

use_mcp_tool
server_name: linear
tool_name: get_tasks
arguments: {
  "assignee": "John",
  "status": "In Progress"
}

Getting details for a specific task

use_mcp_tool
server_name: linear
tool_name: get_task_details
arguments: {
  "taskId": "LIN-123"
}

Listing all teams

use_mcp_tool
server_name: linear
tool_name: get_teams
arguments: {}

Listing all users

use_mcp_tool
server_name: linear
tool_name: get_users
arguments: {}