Linear Issue Data Access Component

This implements a basic Model Context Protocol (MCP) intermediary that furnishes read-only interaction with Linear tracking items. It empowers large language models to query Linear tickets and their related metadata by leveraging a valid Linear Application Programming Interface access key.

Core Capabilities

The service exposes two primary operational methods:

• linear_get_issue: Retrieves fundamental attributes for a specified Linear ticket, locatable via its web address or internal identifier.
• linear_get_issue_with_comments: Extracts the entirety of information pertaining to a Linear ticket, encompassing all recorded user contributions and discussions.

Prerequisites

• Execution environment requiring Node.js runtime.
• A valid Linear API key or an established OAuth access credential.

Deployment Notes

Direct installation is bypassed when utilizing the npx execution mechanism. Ensure Node.js and the accompanying package manager (npm) are correctly situated on the system.

Securing a Linear Access Credential

Authorization tokens can be procured via one of two mechanisms:

1. API Key (Most Direct): Generate a secret key within your designated Linear API configuration area

2. OAuth Flow Credential: For advanced access patterns or user-specific contexts

3. Initiate the creation of a new OAuth application within Linear
4. Proceed through the authorization sequence to obtain an active user access token

Integration with Desktop Assistants (e.g., Claude)

To embed this data access layer into your local application environment:

1. Confirm the Linear authorization secret is readily accessible.

2. Incorporate the service definition into your assistant's configuration file located at:

3. macOS Path: ~/Library/Application Support/Claude/claude_desktop_config.json

4. Linux Path: ~/.config/Claude/claude_desktop_config.json
5. Windows Path: %AppData%\Claude\claude_desktop_config.json

Illustrative Configuration Snippet:

{
  "mcpServers": {
    "linear-issues": {
      "command": "npx",
      "args": ["-y", "@keegancsmith/linear-issues-mcp-server"],
      "env": {
        "LINEAR_API_TOKEN": "your_provided_secret_key_here"
      }
    }
  }
}

1. Relaunch the desktop assistant application.

Operational Examples

Once correctly configured, you can prompt the assistant to interface with Linear items:

Provide me the structural data for the task identified as ENG-123.

The assistant will invoke linear_get_issue, retrieving credentials from the environment settings.

List every recorded interaction on the ticket found at https://linear.app/company/issue/ENG-123/issue-title.

The assistant is capable of utilizing linear_get_issue_with_comments to pull the complete ticket record, including all preceding dialogue.

Licensing

Distributed under the MIT License.