Linear

Provides standardized MCP access to Linear resources, including issues, projects, and comments with CRUD operations.

typescript

1

GitHub Stars

typescript

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": {
    "mkusaka-mcp-server-linear": {
      "command": "npx",
      "args": [
        "-y",
        "@mkusaka/mcp-server-linear"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key"
      }
    }
  }
}

You set up the Linear MCP Server to provide a consistent, programmable interface for Linear resources like issues, projects, and comments. This server lets you perform CRUD operations, search, and manage data through a standardized MCP protocol, enabling seamless integration with AI assistants and MCP clients.

How to use

Connect your MCP client to the Linear MCP Server using the local stdio workflow. Run the server in a way that your client can launch it as a child process and communicate via standard input/output.

How to install

Prerequisites: ensure you have Node.js and npm (or yarn/pnpm) installed on your machine.

Install and run the Linear MCP Server directly with npx, providing your Linear API key.

Starting the server

LINEAR_API_KEY=your_api_key_here npx -y @mkusaka/mcp-server-linear

Usage with MCP clients

This MCP server is designed to work with MCP-compatible clients. Start the server as shown above, then configure your client to connect to the MCP endpoint exposed by the stdio process. You can integrate with AI assistants or tooling that supports MCP to perform actions such as creating and updating issues, managing comments, and querying Linear resources.

Configuration and security

Use a Linear API key to authenticate requests. The example below demonstrates the required environment variable. If you switch to OAuth in your setup, you would provide the OAuth credentials according to your chosen method.

Development

For development and testing, you can run tests, build, and debug as described in the project’s workflow. Use an MCP Inspector to interact with the server during development.

Available tools

create_issue

Create a new Linear issue with fields such as title, description, and assignee.

update_issue

Update an existing Linear issue, including status, description, and fields.

delete_issue

Delete an existing Linear issue.

update_issue_labels

Update the labels assigned to an issue.

update_issue_priority

Change the priority of an issue.

update_issue_estimate

Update the time estimation for an issue.

update_issue_state

Update the lifecycle state of an issue (e.g., open, done).

search_issues

Search for issues using advanced filters and criteria.

create_comment

Add a comment to a specific issue.

update_comment

Modify an existing comment on an issue.

delete_comment

Remove a comment from an issue.

get_issue_comments

Retrieve comments for a specific issue.

projects

List all projects in Linear.

project

Retrieve a single project by ID.

issue

Retrieve a single issue by ID.

project_statuses

Get all project statuses.

project_issues

List all issues within a project.

issue_labels

Get all available issue labels.

issue_states

Get all possible issue states.

get_viewer

Get information about the current user, including teams.

update_project_state

Update the state of a project.