Skip to main content
Glama
Linear MCP Server

Linear MCP Server

Linear MCP

A Model Context Protocol (MCP) server for Linear, providing tools for issue tracking and project management.

Configuration

Go to Linear security settings and create an API key:

linear-security-settings

Then, configure it with the LINEAR_API_KEY env variable:

# Add to your .env file
LINEAR_API_KEY=lin_api_xxxxxxxxxxxx

# Or export as environment variable
export LINEAR_API_KEY=lin_api_xxxxxxxxxxxx

Related MCP server: MCP Linear App

Running the Server

uvx --from git+https://github.com/vinayak-mehta/linear-mcp linear-mcp

Docker

docker build -t linear-mcp:latest .
docker run -it --rm -e LINEAR_API=lin_api_xxxxxx linear-mcp:latest

And to use this in Claude Desktop, it would look like this:

    "linear-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-it",
        "--rm",
        "-e",
        "LINEAR_API_KEY=lin_api_xxxxxx",
        "linear-mcp-server:latest"
      ]
    }

Resources

Linear MCP provides access to the following resource types:

Resource

Description

Example URI

Issue

Details of a specific Linear issue

linear-issue:///a1b2c3d4

Team Issues

All issues for a specific team

linear-team:///ENG/issues

User Issues

Issues assigned to a user

linear-user:///me/assigned

Organization

Details about your Linear organization

linear-organization:

Viewer

Information about the authenticated user

linear-viewer:

Tools

Tool

Description

linear_create_issue

Create a new Linear issue with title, description, and other attributes

linear_update_issue

Update an existing issue's properties

linear_search_issues

Search issues using flexible filtering criteria

linear_get_user_issues

Retrieve issues assigned to a specific user

linear_add_comment

Add a comment to an existing issue

Example Prompts

Creating a New Issue

Create a bug ticket: "Login screen disappears like magic tricks at a birthday party!" Priority: HIGH, Team: Engineering

Updating an Issue

Upgrade ENG-123 to "shooting star" priority! Users are excited! Change status to "Racing to the finish line!"

Searching for Issues

Find all Frontend tasks with "authentication" that are patiently waiting for their moment to shine

Retrieving User Tasks

What exciting challenges await me today in Linear?

Adding a Comment

Add to DEV-456: "Temporarily paused while the API does its beauty routine. Back on it next sprint with fresh energy!"

Organization Overview

Show me our amazing team structure so I can appreciate all the talented people making this happen

License

Apache 2.0

Available Tools

5 tools
linear_add_commentB

Add a comment to an issue.

Args:
    issue_id: Issue ID to comment on
    body: Comment text (markdown supported)
    create_as_user: Custom username
    display_icon_url: Custom avatar URL

Inputs: issue_id (required), body (required), create_as_user, display_icon_url. Returns: result

linear_create_issueB

Create a new Linear issue.

Args:
    title: Issue title
    team_id: Team ID to create issue in
    description: Issue description (markdown supported)
    priority: Priority level (1=urgent, 4=low)
    status: Initial status name

Inputs: title (required), team_id (required), description, priority, +1 more. Returns: result

linear_get_user_issuesB

Get issues assigned to a user.

Args:
    user_id: User ID (omit for authenticated user)
    include_archived: Include archived issues
    limit: Max results (default: 50)

Inputs: user_id, include_archived, limit. Returns: result

linear_search_issuesB

Search issues with flexible filtering.

Args:
    query: Text to search in title/description
    team_id: Filter by team
    status: Filter by status
    assignee_id: Filter by assignee
    labels: Filter by labels
    priority: Filter by priority
    estimate: Filter by estimate points
    include_archived: Include archived issues
    limit: Max results (default: 10)

Inputs: query, team_id, status, assignee_id, +5 more. Returns: result

linear_update_issueB

Update an existing Linear issue.

Args:
    id: Issue ID to update
    title: New title
    description: New description
    priority: New priority (1=urgent, 4=low)
    status: New status name

Inputs: id (required), title, description, priority, +1 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: add_comment, create_issue, get_user_issues, search_issues, and update_issue target specific operations with no overlap. The descriptions reinforce these distinctions, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent 'linear_verb_noun' pattern (e.g., linear_add_comment, linear_create_issue). This predictable naming scheme enhances readability and agent usability without any deviations.

    Tool Count4/5

    With 5 tools, the count is reasonable for a Linear issue management server, covering core operations. It feels slightly thin but not inadequate, as key functions like create, read, update, and search are present.

    Completeness4/5

    The toolset covers essential CRUD operations for Linear issues (create, get, update, comment) and includes search functionality. Minor gaps exist, such as no delete_issue or list_teams tools, but agents can manage core workflows effectively.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
      418 npm
      346
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
      9
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
      21 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      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
      57 npm
      1
      MIT