Linear MCP Server

@dvcrn

Repository

Basic information

About Linear MCP Server

a (working!) MCP server for accessing Linear with multiple workspaces support

#linear #mcp-server #api-integration

Linear MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "mcp-server-linear"
      ],
      "env": {
        "LINEAR_ACCESS_TOKEN": "your_linear_api_token_here"
      }
    }
  },
  "company1-linear": {
    "command": "npx",
    "args": [
      "mcp-server-linear"
    ],
    "env": {
      "LINEAR_ACCESS_TOKEN": "your_company1_linear_token_here",
      "TOOL_PREFIX": "company1"
    }
  }
}

Linear MCP Server tools

Handle OAuth callback

Create a new issue in Linear

Create a new project with associated issues. Note: Project requires teamIds (array) not teamId (single value).

Update multiple issues at once

Edit an existing issue, updating any of its fields. Note: When setting projectMilestoneId, you must also set projectId.

Search for issues with filtering and pagination

Search for issues by their identifiers (e.g., ["ENG-78", "ENG-79"])

Get a single issue by identifier, including all comments

Get all teams with their states and labels

Get current user information

Delete an issue

Get project information

List all projects or filter them by criteria

Create multiple issues at once

Creates a new comment on an issue

Updates an existing comment

Deletes a comment

Resolves a comment

Unresolves a comment

Creates a new customer need from an attachment

Get milestones for a project with filtering and pagination

Create a new project milestone

Update a project milestone

Delete a project milestone

Overview

What is Linear?

An MCP server for interacting with Linear's API. It provides a set of tools for managing Linear issues, projects, and teams through Cline.

How to use Linear?

Obtain a Linear API token (developer token or personal API key) and add the server configuration to your Cline MCP settings JSON file. The server runs automatically via npx when needed.

Key features of Linear

Create, update, delete, and search issues with full field support
Manage comments: create, update, delete, and resolve/unresolve
Create and manage projects with milestones
View team information, states, and workflow details
Batch operations for bulk issue creation and deletion
Support for multiple Linear workspaces via TOOL_PREFIX

Use cases of Linear

Automate creation and updating of Linear issues from external tools
Manage project milestones and associate issues with projects
Perform bulk issue creation and deletion for large-scale workflows
Use multiple Linear workspaces in a single Cline environment

Frequently asked questions

What types of authentication are supported?

The server supports Personal Access Token (PAT) authentication. OAuth flow with automatic token refresh is in development.

How to configure multiple Linear workspaces?

Set the `TOOL_PREFIX` environment variable per workspace instance. The prefix is added to all tool names and descriptions, preventing conflicts between different Linear instances.

How to create parent/child issue relationships?

Specify the parent issue's UUID (not the issue identifier like "ENG-123") in the `parentId` field when creating a new issue.

Where is the Cline MCP configuration file located?

On macOS: `~/Library/Application Support/Code/User/globalStorage/s

Comments

More Version Control MCP servers

Jira MCP

nguyenvanduocit

A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow tra