Linear Issues

Provides read-only access to issues within the Linear project management tool.

GitHub

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

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"
      }
    }
  }
}
  1. 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

เซิร์ฟเวอร์ที่เกี่ยวข้อง