Linear Issues MCP Server
About
The Linear Issues MCP Server is a read-only MCP server that enables language models to fetch Linear issues and their associated data using a Linear API token. It is designed for developers who want to query Linear issues directly from Claude for Desktop or other MCP clients.
Details
- License
- MIT license
Explore
The server provides two tools:
- linear_get_issue: Fetches basic details about a Linear issue by URL or identifier
- linear_get_issue_with_comments: Fetches complete information about a Linear issue including all comments
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
Linear Issues MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js
- A Linear API token or OAuth access token
You can obtain a Linear API token in two ways:
1. API Key (simplest): Generate an API key in your Linear API settings
2. OAuth Token: For more advanced use cases or user-specific access
- Create an OAuth2 application in Linear
- Follow the OAuth flow to get a user access token
To use this MCP server with Claude for Desktop:
1. Make sure you have your Linear API token ready
2. Add the server to your Claude for Desktop configuration at:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
- Windows: %AppData%\Claude\claude_desktop_config.json
Example configuration:
{
"mcpServers": {
"linear-issues": {
"command": "npx",
"args": ["-y", "@keegancsmith/linear-issues-mcp-server"],
"env": {
"LINEAR_API_TOKEN": "your_linear_api_token_here"
}
}
}
}
3. Restart Claude for Desktop
Once the server is set up, you can use it in Claude to interact with Linear issues:
Can you get me the details for issue ENG-123?
Claude will use the linear_get_issue tool with your issue ID, accessing the token from environment variables.
What are all the comments on the issue at https://linear.app/company/issue/ENG-123/issue-title?
Claude can use linear_get_issue_with_comments to fetch the full issue details including comments.
linear_get_issue
Fetch details of a single Linear issue by providing its URL or identifier.
linear_get_issue_with_comments
Fetch a Linear issue with all its comments and complete information.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"linear issues mcp server": {
"linear-issues": {
"command": "npx",
"args": [
"-y",
"@keegancsmith/linear-issues-mcp-server"
],
"env": {
"LINEAR_API_TOKEN": "your_linear_api_token_here"
}
}
}
}
}McpServers
{
"linear-issues": {
"command": "npx",
"args": [
"-y",
"@keegancsmith/linear-issues-mcp-server"
],
"env": {
"LINEAR_API_TOKEN": "your_linear_api_token_here"
}
}
}This is a simple MCP (Model Context Protocol) server that provides read-only access to Linear issues. It allows language models to fetch Linear issues and their associated data using a Linear API token.
Features
The server provides two tools:
- linear_get_issue: Fetches basic details about a Linear issue by URL or identifier
- linear_get_issue_with_comments: Fetches complete information about a Linear issue including all comments
Requirements
- Node.js
- A Linear API token or OAuth access token
Installation
No installation is needed if you use npx. Just make sure you have Node.js and npm installed.
Getting a Linear API Token
You can obtain a Linear API token in two ways:
1. API Key (simplest): Generate an API key in your Linear API settings
2. OAuth Token: For more advanced use cases or user-specific access
- Create an OAuth2 application in Linear
- Follow the OAuth flow to get a user access token
Usage with Claude for Desktop
To use this MCP server with Claude for Desktop:
1. Make sure you have your Linear API token ready
2. Add the server to your Claude for Desktop configuration at:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
- Windows: %AppData%\Claude\claude_desktop_config.json
Example configuration:
{
"mcpServers": {
"linear-issues": {
"command": "npx",
"args": ["-y", "@keegancsmith/linear-issues-mcp-server"],
"env": {
"LINEAR_API_TOKEN": "your_linear_api_token_here"
}
}
}
}
3. Restart Claude for Desktop
Example Usage
Once the server is set up, you can use it in Claude to interact with Linear issues:
Can you get me the details for issue ENG-123?
Claude will use the linear_get_issue tool with your issue ID, accessing the token from environment variables.
What are all the comments on the issue at https://linear.app/company/issue/ENG-123/issue-title?
Claude can use linear_get_issue_with_comments to fetch the full issue details including comments.
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
