linear-mcp

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: {}