This Linear MCP Server exposes a programmatic interface to access Linear resources via the MCP protocol. It supports creating issues, searching issues with a variety of filters, and reading resources such as organizations, issues, and teams through the linear:// URIs. You can integrate it with Cursor by running a small shell script that injects your Linear API key and launches the server, then configuring Cursor to point at that command. The server enforces rate limiting (1000 requests per hour) and returns structured error messages for API issues, rate limits, invalid resources, and authentication problems. Tools available include: create-issue to programmatically create new Linear issues with fields like title, teamId, description, priority, stateId, assigneeId, estimate, and labelIds; search-issues to filter and retrieve issues using criteria such as assignee, priority, state/status, team, label, and free text search; and read-resource to fetch details for common Linear resources using linear:// URIs such as linear://organization, linear://issues, linear://issues/{id}, linear://teams, and linear://teams/{id}.

Prerequisites:

• Node.js and npm installed on your machine
• Access to your Linear API key

Installation steps:

1. Clone the repository and install dependencies: git clone git@github.com:Iwark/linear-mcp-server.git cd linear-mcp-server npm install

2. Create a startup script to inject your API key and start the server:

   Create linear.sh

   touch linear.sh chmod +x linear.sh

   Add the following content (replace <YOUR LINEAR API KEY> with your key)

   export LINEAR_API_KEY="<YOUR LINEAR API KEY>" node index.js

3. Run the server locally (alternative): npm start

4. Configure Cursor to use the server via a Command-type MCP entry (as described in the README):

   • Command: sh /absolute/path/to/linear.sh

Note: Ensure that the path to index.js in linear.sh is correct for your setup.

Tips and notes:

• Keep your LINEAR_API_KEY secure and do not commit it to version control.
• The server exposes three main tools (create-issue, search-issues, read-resource); consult the README for exact parameter formats and supported filters.
• If you encounter authentication errors, double-check that LINEAR_API_KEY is correctly exported in your startup script and that the key has the required permissions.
• Cursor configuration uses a Command-type MCP entry; ensure the script path is absolute and executable.
• If you hit rate limiting, respect the 1000 requests/hour limit and implement appropriate backoff in your consuming client.