mcpField
L
Linear MCP Server

Linear MCP Server

Local
github.com/Tyru5Version Control1Updated 78w ago
Repository

About Linear MCP Server

Linear MCP Server provides tools for retrieving Linear tasks and related workspace details. It is intended for MCP clients that need to filter tasks or look up task, team, and user information.

Key features

  1. 01Filter tasks by status, assignee, and team
  2. 02Set a task result limit
  3. 03Retrieve details for a task ID
  4. 04List workspace teams and users

Use cases

  1. 01Find tasks by status and assignee
  2. 02Look up a specific task’s details
  3. 03List teams in a Linear workspace
  4. 04Retrieve users in a Linear workspace

MCP support

The MCP server exposes tools for querying Linear tasks, retrieving task details, and listing workspace teams and users.

#linear-mcp#mcp-server#linear-api

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.