Linear

Provides MCP access to Linear resources including create, search, and read operations via a local server.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

This Linear MCP Server provides an MCP interface to access Linear resources from an MCP client. It enables you to perform actions like creating issues, searching issues, and reading Linear resources through a streamlined, programmable endpoint.

How to use

You connect to the Linear MCP Server from your MCP client by configuring it as an MCP endpoint that runs a local startup script. The server exposes tools to create issues, search issues, and read resources from Linear. You will set up a small wrapper script that launches the server and provides your Linear API key via an environment variable.

How to install

Prerequisites: You need Node.js and npm installed on your machine.

Clone the project repository.

git clone git@github.com:Iwark/linear-mcp-server.git
cd linear-mcp-server
npm install

Create a startup script that launches the server with your Linear API key.

# 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 the MCP client to use this server. In your MCP client settings, add a new MCP Server entry with the following details.

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

Start the server locally.

npm start

Additional configuration and notes

The server requires your Linear API key to be available as an environment variable named LINEAR_API_KEY. Ensure this value is set in the startup script or your environment before starting the server.

Rate limiting is enforced at 1000 requests per hour with automatic request tracking. Metrics are included in each response for observability.

Error handling provides detailed messages for Linear API errors, rate limit issues, invalid resource types, and authentication problems.

Available tools

create-issue

Create a new Linear issue with specified parameters such as title, teamId, description, priority, stateId, assigneeId, estimate, and labelIds.

search-issues

Search Linear issues using a query string with filters like assignee, priority, state, team, and label, plus free text search.

read-resource

Read Linear resources using URI-like paths such as linear://organization, linear://issues, linear://issues/{id}, linear://teams, and linear://teams/{id}.