Linear MCP Server

by Tyru5

Integrations

  • Provides tools for interacting with Linear's API, allowing users to fetch tasks with filtering options (by status, assignee, team), retrieve detailed task information, and list teams and users in a Linear workspace.

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Provides tools to interact with the Linear API, allowing users to fetch tasks, task details, teams, and users from their Linear workspace.

  1. Setup
    1. Available Tools
      1. get_tasks
      2. get_task_details
      3. get_teams
      4. get_users
    2. Usage Examples
      1. Fetching tasks assigned to a specific user
      2. Getting details for a specific task
      3. Listing all teams
      4. Listing all users

    Related MCP Servers

    • A
      security
      A
      license
      A
      quality
      Enables AI agents to manage issues, projects, and teams on the Linear platform programmatically.
      Last updated -
      7
      123
      22
      JavaScript
      MIT License
      • Apple
    • -
      security
      F
      license
      -
      quality
      Facilitates project management with the Linear API via the Model Context Protocol, allowing users to manage initiatives, projects, issues, and their relationships through features like creation, viewing, updating, and prioritization.
      Last updated -
      324
      4
      TypeScript
    • A
      security
      F
      license
      A
      quality
      Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
      Last updated -
      7
      123
      1
      JavaScript
      • Apple
    • -
      security
      A
      license
      -
      quality
      A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
      Last updated -
      15
      1
      TypeScript
      MIT License

    View all related MCP servers

    ID: uhlvwalsfa