What is Linear Issues Mcp Server

linear-issues-mcp-server is a simple MCP server that provides read-only access to Linear issues through API tokens, enabling language models to fetch issue data efficiently.

Use cases

Use cases include integrating with AI assistants to retrieve issue details, automating issue tracking workflows, and enhancing project management tools with real-time issue data.

How to use

To use linear-issues-mcp-server, obtain a Linear API token, configure it in your application (e.g., Claude for Desktop), and utilize the provided tools to fetch issue details or comments.

Key features

Key features include two main tools: ‘linear_get_issue’ for fetching basic issue details and ‘linear_get_issue_with_comments’ for retrieving complete issue information along with comments.

Where to use

linear-issues-mcp-server is suitable for software development environments where tracking and managing Linear issues is essential, particularly in Agile and project management contexts.

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