Linear
About
Bridges Linear's project management platform by retrieving user todo tickets via user ID or email, enabling seamless integration of project context into workflow tools.
Details
- Author
- argia-andreas
- Repository
- argia-andreas/linear-mcp-server
- Categories
- Productivity, Design, Developer Tools, AI, Infrastructure, Frontend
- Tags
- #integration
Jump to
- Get a user's todo tickets by user ID or email address
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
LinearCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Clone this repository
2. Install dependencies:
npm install
3. Create a
.env file at the root of the project (copy from .env.example): LINEAR_API_KEY=your_linear_api_key_here
Get your Linear API key from the Linear Developer Console
get-user-todo-tickets
Gets all tickets in the 'Todo' state for a specified user. Parameters: userId (optional), email (optional). Note: You must provide either userId or email.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"linear": {
"env": {},
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}
}
}Linux
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Macos
{
"env": [],
"args": [
"-y",
"@highlight/mcp-server"
],
"command": "npx"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"-y",
"@highlight/mcp-server"
],
"command": "cmd"
}Linear MCP Server
A Model Context Protocol (MCP) server for interacting with Linear. This server allows AI assistants to fetch data from Linear through the MCP standard.
Current Features
- Get a user's todo tickets by user ID or email address
Installation
1. Clone this repository
2. Install dependencies:
npm install
3. Create a
.env file at the root of the project (copy from .env.example): LINEAR_API_KEY=your_linear_api_key_here
Get your Linear API key from the Linear Developer Console
Development
Run the development server (with hot reload):
npm run dev
Building for Production
Build the TypeScript code:
npm run build
Run the compiled code:
npm start
Using with MCP clients
This MCP server implements the standard MCP protocol and can be used with any MCP client. The server exposes the following tools:
Using with Claude Code
To use this MCP server with Claude Code, run the following command:
claude mcp add linear-mcp-server -- node dist/index.js
This registers the Linear MCP server with Claude Code, allowing you to access Linear tickets directly from your Claude conversations.
get-user-todo-tickets
Gets all tickets in the "Todo" state for a specified user.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
