Linear MCP Server

What is Linear MCP Server?

A Model Context Protocol (MCP) server implementation that provides an MCP interface for accessing Linear resources, designed for use with Cursor.

How to use Linear MCP Server?

Clone the repository, install dependencies, and create a startup script exporting your Linear API key. Configure the script as a Command-type MCP server in Cursor settings, then start the server with npm start.

Key features of Linear MCP Server

• Create Linear issues with title, team, and optional fields
• Search issues with filters by assignee, priority, state, team, label
• Read Linear resources via URIs (organization, issues, teams)
• Rate limiting: 1000 requests per hour
• Detailed error messages for API errors and rate limit exceeded

Use cases of Linear MCP Server

• Creating new Linear issues directly from within Cursor
• Searching and filtering Linear issues using natural language queries
• Reading organization details, issue lists, and team information
• Automating issue management workflows with an MCP-compatible client

FAQ from Linear MCP Server

How do I get a Linear API key?

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

How do I set up the server with Cursor?

Clone the repo, create a shell script that exports your API key and points to the server’s index.js, then add a new MCP server in Cursor settings using the Command type with that script path.

What tools does the server provide?

It provides three tools: create-issue to create issues, search-issues to search with filters, and read-resource to read Linear data via URIs.

Is there a rate limit?

Yes, the server enforces a limit of 1000 requests per hour, with automatic request tracking and metrics included in each response.

What error handling is included?

The server returns detailed error messages for Linear API errors, rate limit exceeded, invalid resource types, and other invalid requests.