@keegancsmith/linear-issues-mcp-server

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-mcp": {
      "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