Skip to content

Latest commit

 

History

History
98 lines (69 loc) · 2.42 KB

README.md

File metadata and controls

98 lines (69 loc) · 2.42 KB

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

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