Linear MCP Server

by cline

133 stars

551 downloads

Not rated

GitHub

Developer Tools

About

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

Details

Author: cline
GitHub stars: 133
Downloads: 551
Categories: Developer Tools

- Create, update, delete, and search issues with full field support.
- Manage projects with rich text descriptions using Linear's documentContent field.
- Access team information, states, and labels.
- Support for bulk issue creation and deletion.
- API Key and OAuth authentication (OAuth not yet implemented).

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Linear MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

From the repository

Clone the repository, install dependencies (npm install), copy .env.example to .env, and configure authentication using an API key from Linear Settings. Then build (npm run build) and start (npm start) the server. Integrate with Cline by adding the server configuration to your Cline MCP settings file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "linear mcp server": {
            "linear": {
                "command": "node",
                "args": [
                    "/path/to/linear-mcp/build/index.js"
                ],
                "env": {
                    "LINEAR_API_KEY": ""
                }
            }
        }
    }
}

McpServers

{
    "linear": {
        "command": "node",
        "args": [
            "/path/to/linear-mcp/build/index.js"
        ],
        "env": {
            "LINEAR_API_KEY": ""
        }
    }
}

Linear MCP Server

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

Setup Guide

1. Environment Setup

1. Clone the repository
2. Install dependencies:

   npm install

3. Copy .env.example to .env:

   cp .env.example .env

2. Authentication

The server supports two authentication methods:

API Key (Recommended)

1. Go to Linear Settings
2. Navigate to the "Security & access" section
3. Find the "Personal API keys" section
4. Click "New API key"
5. Give the key a descriptive label (e.g. "Cline MCP")
6. Copy the generated token immediately
7. Add the token to your .env file:

   LINEAR_API_KEY=your_api_key

OAuth Flow (Alternative) NOT IMPLEMENTED

1. Create an OAuth application at https://linear.app/settings/api/applications
2. Configure OAuth environment variables in .env:

   LINEAR_CLIENT_ID=your_oauth_client_id

   LINEAR_CLIENT_SECRET=your_oauth_client_secret

   LINEAR_REDIRECT_URI=http://localhost:3000/callback

3. Running the Server

1. Build the server:

   npm run build

2. Start the server:

   npm start

4. Cline Integration

1. Open your Cline MCP settings file:
- macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Add the Linear MCP server configuration:

   {

     "mcpServers": {

       "linear": {

         "command": "node",

         "args": ["/path/to/linear-mcp/build/index.js"],

         "env": {

           "LINEAR_API_KEY": "your_personal_access_token"

         },

         "disabled": false,

         "autoApprove": []

       }

     }

   }

Available Actions

The server currently supports the following operations:

Issue Management

- ✅ Create issues with full field support (title, description, team, project, etc.) - ✅ Update existing issues (priority, description, etc.) - ✅ Delete issues (single or bulk deletion) - ✅ Search issues with filtering - ✅ Associate issues with projects - ✅ Create parent/child issue relationships - ✅ Read and create comments and threaded comments

Project Management

- ✅ Create projects with associated issues - ✅ Get project information with rich text descriptions - ✅ Search projects with rich text descriptions - ✅ Associate issues with projects - ✅ Proper description handling using Linear's documentContent field

Team Management

- ✅ Get team information (with states and workflow details) - ✅ Access team states and labels

Authentication

- ✅ API Key authentication - ✅ Secure token storage

Batch Operations

- ✅ Bulk issue creation - ✅ Bulk issue deletion

Bulk Updates (In Testing)

- 🚧 Bulk issue updates (parallel processing implemented, needs testing)

Rich Text Description Support

The server now properly handles Linear's rich text descriptions for projects:

- Legacy Support: Maintains compatibility with the old description field
- Rich Content: Uses Linear's documentContent field for actual description content
- Automatic Fallback: Falls back to legacy field if rich content is unavailable
- Type Safety: Includes proper TypeScript types for both description formats

How It Works

Linear uses a dual-field system for descriptions:
1. description - Legacy field (often empty for backward compatibility)
2. documentContent.content - Contains the actual rich text description content

The MCP server automatically:
- Queries both fields from Linear's API
- Prioritizes documentContent.content over the legacy description field
- Provides a utility function getProjectDescription() for consistent access
- Returns an actualDescription field in responses for easy access

Features in Development

The following features are currently being worked on:

Issue Management

- 🚧 Complex search filters - 🚧 Pagination support for large result sets

Metadata Operations

- 🚧 Label management (create/update/assign) - 🚧 Cycle/milestone management

Project Management

- 🚧 Project template support - 🚧 Advanced project operations

Authentication

- 🚧 OAuth flow with automatic token refresh

Performance & Security

- 🚧 Rate limiting - 🚧 Detailed logging - 🚧 Load testing and optimization

Development

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Linear MCP Server

Setup Guide

1. Environment Setup

2. Authentication

API Key (Recommended)

OAuth Flow (Alternative) NOT IMPLEMENTED

3. Running the Server

4. Cline Integration

Available Actions

Issue Management

Project Management

Team Management

Authentication

Batch Operations

Bulk Updates (In Testing)

Rich Text Description Support

How It Works

Features in Development

Issue Management

Metadata Operations

Project Management

Authentication

Performance & Security

Development

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright