linear mcp server

Local 2025-09-01 00:13:00 0

Developer Tools @Iwark/linear-mcp-server

Enables interaction with Linear resources through an MCP interface, offering functionality for issue management and resource retrieval with rate limiting and error handling support.

A Linear Model Context Protocol (MCP) server implementation that provides an MCP interface for accessing Linear resources.

Setup with Cursor

Clone the repository and install dependencies:

git clone [email protected]:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

Create a startup script:

# Create linear.sh
touch linear.sh
chmod +x linear.sh

# Add the following content
export LINEAR_API_KEY="<YOUR LINEAR API KEY>"
node /absolute/path/to/linear-mcp-server/index.js

Configure in Cursor:
Open Cursor settings
Add a new server in the MCP Server section
Select Type: Command
Set Command: sh /absolute/path/to/linear.sh

Now you can use the Linear MCP server from within Cursor.

You can obtain your Linear API key from the Linear settings page.

Start the server:

npm start

Available Tools

create-issue

Create a new Linear issue with specified parameters:

title (required): Issue title
teamId (required): Team ID
description (optional): Issue description
priority (optional): Issue priority (0: No priority, 1: Urgent, 2: High, 3: Medium, 4: Low)
stateId (optional): State ID
assigneeId (optional): Assignee ID
estimate (optional): Issue estimate
labelIds (optional): Array of Label IDs

search-issues

Search Linear issues using a query string. Supports various filters:

assignee:@me: Show issues assigned to you
priority:[value]: Filter by priority
Numeric values (0-4)
Text values: "no", "urgent", "high", "medium", "low"
Note: priority:high includes both Urgent and High priority issues
state:[value] or status:[value]: Filter by state name
team:[value]: Filter by team name
label:[value]: Filter by label name
Free text search for title and description

read-resource

Read Linear resources using URIs:

linear://organization - Organization details
linear://issues - List of issues
linear://issues/{id} - Specific issue details
linear://teams - List of teams
linear://teams/{id} - Specific team details

Rate Limiting

The server implements rate limiting with:

1000 requests per hour limit
Automatic request tracking
Metrics included in each response

Error Handling

The server provides detailed error messages for:

Linear API errors
Rate limit exceeded
Invalid resource types
Authentication issues

[
  {
    "description": "Create a new Linear issue",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "assigneeId": {
          "description": "Assignee ID",
          "type": "string"
        },
        "description": {
          "description": "Issue description",
          "type": "string"
        },
        "estimate": {
          "description": "Issue estimate",
          "type": "number"
        },
        "labelIds": {
          "description": "Label IDs",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "priority": {
          "description": "Issue priority (0: No priority, 1: Urgent, 2: High, 3: Medium, 4: Low)",
          "maximum": 4,
          "minimum": 0,
          "type": "number"
        },
        "stateId": {
          "description": "State ID",
          "type": "string"
        },
        "teamId": {
          "description": "Team ID",
          "type": "string"
        },
        "title": {
          "description": "Issue title",
          "type": "string"
        }
      },
      "required": [
        "title",
        "teamId"
      ],
      "type": "object"
    },
    "name": "create-issue"
  },
  {
    "description": "Search Linear issues",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "assigneeId": {
          "description": "Assignee ID to filter by",
          "type": "string"
        },
        "query": {
          "description": "Search query",
          "type": "string"
        },
        "status": {
          "description": "Status to filter by",
          "type": "string"
        },
        "teamId": {
          "description": "Team ID to filter by",
          "type": "string"
        }
      },
      "required": [
        "query"
      ],
      "type": "object"
    },
    "name": "search-issues"
  },
  {
    "description": "Read a Linear resource",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "uri": {
          "description": "Resource URI to read e.g. linear://issues/4cb972e7-9ba1-4c52-8465-cdf2679ccea7",
          "type": "string"
        }
      },
      "required": [
        "uri"
      ],
      "type": "object"
    },
    "name": "read-resource"
  }
]