Linear MCP Server – README | MCP Marketplace

✨ From vibe coding to vibe deployment. UBOS MCP turns ideas into infra with one message.

Learn more

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

Featured Templates

View More
Data Analysis
Pharmacy Admin Panel
238 1704
Verified Icon
AI Assistants
Speech to Text
134 1510
Customer service
AI-Powered Product List Manager
147 625
Verified Icon
AI Agents
AI Chatbot Starter Kit
1308 6081 5.0

Start your free trial

Build your solution today. No credit card required.

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.