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 titleteamId
(required): Team IDdescription
(optional): Issue descriptionpriority
(optional): Issue priority (0: No priority, 1: Urgent, 2: High, 3: Medium, 4: Low)stateId
(optional): State IDassigneeId
(optional): Assignee IDestimate
(optional): Issue estimatelabelIds
(optional): Array of Label IDs
search-issues
Search Linear issues using a query string. Supports various filters:
assignee:@me
: Show issues assigned to youpriority:[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]
orstatus:[value]
: Filter by state nameteam:[value]
: Filter by team namelabel:[value]
: Filter by label name- Free text search for title and description
read-resource
Read Linear resources using URIs:
linear://organization
- Organization detailslinear://issues
- List of issueslinear://issues/{id}
- Specific issue detailslinear://teams
- List of teamslinear://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
Linear MCP Server
Project Details
- Iwark/linear-mcp-server
- linear-mcp-server
- Last Updated: 3/6/2025
Recomended MCP Servers
DOC TALK - AI is an interactive application that allows users to chat with their documents using artificial...
MCP Server for Odoo
MCP DevTools: A suite of Model Context Protocol servers enabling AI assistants to interact with developer tools and...
A Model Context Protocol (MCP) server that enables LLMs to interact with Anki flashcard software through AnkiConnect.
A MCP server project that creates PowerPoint presentations, forked from supercurses/powerpoint with additional features
MCP Mail Tool - AI-powered email management tool | 基于 MCP 的智能邮件管理工具
DuckDuckGo search implementation for Model Context Protocol (MCP)
A MS excel server based on modelcontextprotocol