Overview
What is Linear MCP Server?
Linear MCP Server is a Model Context Protocol (MCP) server that provides an interface for accessing and managing Linear resources, such as issues and teams. It is designed for developers who want to interact with Linear from within MCP‑compatible tools like Cursor.
How to use Linear MCP Server?
Clone the repository, install dependencies with npm install, create a startup script exporting your LINEAR_API_KEY, and configure the server as a Command‑type MCP server in Cursor pointing to that script. Alternatively, run npm start directly. Obtain a Linear API key from the Linear settings page.
Key features of Linear MCP Server
- Create Linear issues with title, team, description, priority, and more
- Search issues using flexible filters (assignee, priority, state, team, label)
- Read Linear resources via URIs (organization, issues, teams)
- Rate limiting set at 1000 requests per hour
- Detailed error messages for API and rate‑limit errors
Use cases of Linear MCP Server
- Create new tickets directly from a code editor
- Search and filter issues to quickly find specific work items
- Read issue details, team info, or organization data via simple URIs
FAQ from Linear MCP Server
How do I get a Linear API key?
Generate a personal API key from your Linear settings page at https://linear.app/settings/api.
What tools does the server provide?
The server offers three tools: create-issue (creates issues), search-issues (searches with filters), and read-resource (reads Linear resources by URI).
What is the rate limit?
The server enforces a limit of 1000 requests per hour, with automatic tracking and metrics included in responses.
How do I install and run the server?
Clone the repository, run npm install, then either start with npm start or set up a startup script for use with Cursor.
Where does data live?
All data is read from and written to Linear’s API. The server does not store data locally.
