What is Linear Mcp Server

The linear-mcp-server is an implementation of a Linear Model Context Protocol (MCP) server that provides an interface for accessing Linear resources, allowing users to interact with Linear’s project management features programmatically.

Use cases

Use cases include automating issue creation, retrieving and filtering issues based on specific criteria, integrating Linear with other tools, and enhancing team productivity through streamlined access to project data.

How to use

To use linear-mcp-server, clone the repository, install dependencies, create a startup script with your Linear API key, configure it in Cursor, and start the server using ‘npm start’.

Key features

Key features include creating new Linear issues, searching for issues with various filters, reading Linear resources via URIs, rate limiting of 1000 requests per hour, and detailed error handling for API errors and authentication issues.

Where to use

linear-mcp-server can be used in project management, software development, and team collaboration environments where Linear is utilized for tracking issues and managing workflows.

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 [email protected]:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

2. 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

3. 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.

3. 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