Linear MCP Server

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 git@github.com: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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

Code Snippet Server
ngeojiajun
A
security
A
license
A
quality
A MCP server for managing and storing code snippets in various programming languages, allowing users to create, list, and delete snippets via a standardized interface.
Last updated -
3
4
JavaScript
MIT License
MCP Server Linear
floodfx
A
security
A
license
A
quality
An MCP server that provides tools for interacting with Linear issue tracking system, currently supporting issue search with plans to expand to issue creation, updates, comments, and project management.
Last updated -
1
73
1
TypeScript
MIT License
Unstructured API MCP Serverofficial
Unstructured-IO
A
security
F
license
A
quality
An MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.
Last updated -
39
28
Backlog MCP Server
fleagne
A
security
A
license
A
quality
An MCP server implementation that integrates with Backlog API, enabling project management operations including issues, projects, and wikis through natural language interactions.
Last updated -
12
53
3
TypeScript
MIT License

View all related MCP servers

Linear MCP Server