Linear Issues MCP Server

by MCP-Mirror

215 downloads

Not rated

GitHub

Developer Tools

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

Author: MCP-Mirror
Downloads: 215
Categories: Developer Tools

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 Server

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

JSON

{
    "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"
                }
            }
        }
    }
}

From the repository

No installation is needed if you use npx. Configure the server in your Claude for Desktop configuration file (e.g., claude_desktop_config.json) with the command npx -y @keegancsmith/linear-issues-mcp-server and set the environment variable LINEAR_API_TOKEN to your Linear API key or OAuth token. Once running, you can ask Claude to fetch issue details or comments by providing an issue identifier or URL.

`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"
        }
    }
}

Linear Issues MCP Server

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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

linear_get_issue

linear_get_issue_with_comments

Claude Desktop / Cursor

McpServers

Linear Issues MCP Server

Features

Requirements

Installation

Getting a Linear API Token

Usage with Claude for Desktop

Example Usage

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`linear_get_issue`

`linear_get_issue_with_comments`