Skip to main content
Glama
Linear MCP Server

Linear MCP Server

by Iwark

Linear MCP Server

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

Setup with Cursor

  1. Clone the repository and install dependencies:

git clone git@github.com:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install
  1. 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
  1. 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.

  1. Start the server:

npm start

Related MCP server: MCP Linear.app Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      An MCP server for managing Linear issues, projects, teams, and milestones through the Model Context Protocol. It enables users to create, update, and list workspace resources including issue statuses, comments, and user details.
      24 npm
      ISC
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP server that enables interaction with Linear.app's API for issue tracking, project management, and workflow automation. It allows users to create, update, and search issues, manage cycles and labels, and perform team operations through natural language.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage Linear workspace resources such as issues, projects, teams, cycles, and comments via Streamable HTTP MCP, with LLM-optimized tools and batch operations.
      578 npm
      MIT