Linear MCP Server

🚀 Linear MCP Server

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

🚀 Quick Start

Installation

1. Clone the repository and install dependencies:

git clone git@github.com:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

2. Create a startup script:

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

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

3. Configure in Cursor:

• Open Cursor settings.
• Add a new server to the MCP servers section.
• Select type: Command.
• Set the command: sh /absolute/path/linear.sh

Now you can use the Linear MCP server within Cursor.

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

4. Start the server:

npm start

💻 Usage Examples

create-issue

Create a new Linear issue by specifying the following 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 for Linear issues using a query string with various filters supported:

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

read-resource

Read Linear resources using URIs:

• linear://organization - Organization information.
• linear://issues - List of issues.
• linear://issues/{id} - Details of a specific issue.
• linear://teams - List of teams.
• linear://teams/{id} - Details of a specific team.

🔧 Technical Details

Rate Limiting

The server implements rate limiting:

• 1000 requests per hour limit.
• Automatic request tracking.
• Metric information is included in responses.

Error Handling

The server provides detailed error messages, including:

• Linear API errors.
• Request limit exceeded.
• Invalid resource types.
• Authentication issues.