Skip to main content
Glama
Linear Issues MCP Server

Linear Issues MCP Server

by keegancsmith

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

Related MCP server: Linear MCP Server

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

Available Tools

2 tools
linear_get_issueB

Fetch details of a single Linear issue by providing its URL or identifier.

Inputs: issue (required).

linear_get_issue_with_commentsC

Fetch a Linear issue with all its comments and complete information.

Inputs: issue (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.8/5.0

    Scored across 2 tools

    Disambiguation2/5

    The two tools have overlapping purposes, as both fetch Linear issues, with the second tool adding comments. An agent could easily misselect between them when only basic issue details are needed, since the descriptions don't clearly differentiate when to use each beyond the comment inclusion. This creates ambiguity in tool selection for common workflows.

    Naming Consistency5/5

    Both tools follow a consistent naming pattern with the prefix 'linear_get_issue' and descriptive suffixes ('', '_with_comments'), using snake_case uniformly. The naming is predictable and clearly indicates the domain and action, making it easy for agents to understand the tool set's structure.

    Tool Count2/5

    With only 2 tools, this server feels severely under-scoped for managing Linear issues, a domain that typically requires CRUD operations like create, update, delete, search, and list. The limited tool count suggests incomplete coverage, making it difficult for agents to perform basic tasks beyond fetching issues.

    Completeness1/5

    The tool surface is severely incomplete for a Linear issues server, lacking essential operations such as creating, updating, deleting, listing, or searching issues. Agents will encounter dead ends when trying to perform common workflows, as the tools only support fetching issue details with or without comments, leaving major gaps in functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.
      198
      88,174 npm
      151
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      A Model Context Protocol server that enables large language models to interact with Linear's issue tracking system, allowing management of issues, projects, teams, and other Linear resources.
      19
      21 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      An MCP server for managing Linear issues, projects, teams, and milestones through the Model Context Protocol. It enables users to create, update, and list workspace resources including issue statuses, comments, and user details.
      ISC
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that integrates with Linear's API, enabling users to manage issues, projects, teams, and comments through natural language. It supports creating, updating, deleting, and searching issues, as well as project and team management.
      25
      2,467 npm
      MIT