README.md•2.25 kB
# 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](https://linear.app/settings/api)
2. **OAuth Token:** For more advanced use cases or user-specific access
- [Create an OAuth2 application in Linear](https://linear.app/settings/api/applications/new)
- 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:
```json
{
"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