Linear

Name: Linear
Author: dvcrn

@dvcrn

Repository

About Linear

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

#linear #mcp-server #api-integration

Basic information

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"
    }
  }
}

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

FAQ from Linear

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.