Linear

MCP server for Linear to manage issues, teams, and organization data via API-powered actions.

python

6

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "vinayak-mehta-linear-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/linear-mcp",
        "linear-mcp"
      ],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxxxxxxxxxxx"
      }
    }
  }
}

Linear MCP is a server that lets you manage Linear issues and projects through a Model Context Protocol (MCP) interface. It exposes actions for creating and updating issues, searching, and commenting, so you can integrate Linear data into your MCP-enabled workflows and assistants.

How to use

You interact with Linear MCP through an MCP client. Core capabilities include creating new issues, updating existing ones, searching for issues with flexible filters, retrieving issues assigned to users, adding comments, and viewing organizational context. You can reference and use resources such as issues, team issues, user issues, organization, and viewer information to build rich MCP prompts and automations.

How to install

Prerequisites: ensure you have access to either a compatible MCP runtime (such as uvx) or Docker on your system.

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

If you prefer running via Docker, build and run the image as shown below.

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

Additional notes

Configuration requires your Linear API key to be available to the server. Set the LINEAR_API_KEY environment variable in your environment so the MCP can authenticate with Linear.

Tools and capabilities

Linear MCP exposes a set of tools that you can call from your MCP client. Available tools include creating, updating, and querying issues, as well as adding comments and retrieving user-specific issues.

Available tools

linear_create_issue

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

linear_update_issue

Update properties of an existing Linear issue, such as its title, description, priority, or status.

linear_search_issues

Query issues using flexible filtering criteria to find relevant work.

linear_get_user_issues

Retrieve issues assigned to a specific Linear user.

linear_add_comment

Add a comment to an existing Linear issue.