Linear

by Highlight

Recommended

442 downloads

GitHub

About

The Linear MCP Server is a tool designed to facilitate the management of tasks and projects in Linear through an MCP server interface. It provides comprehensive capabilities for handling Linear issues, projects, and teams, allowing users to create, update, delete, and search for…

Details

Author: Highlight
Repository: highlight-ing/linear-mcp
Downloads: 442
Categories: Workplace, Productivity

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

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

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/linear-mcp/build/index.js
Environment
- LINEAR_ACCESS_TOKEN your_personal_access_token
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": {
            "env": {
                "LINEAR_ACCESS_TOKEN": "your_personal_access_token"
            },
            "args": [
                "/path/to/linear-mcp/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

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

JSON

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

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": {
            "env": {
                "LINEAR_ACCESS_TOKEN": "your_personal_access_token"
            },
            "args": [
                "/path/to/linear-mcp/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

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

JSON

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

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": {
            "env": {
                "LINEAR_ACCESS_TOKEN": "your_personal_access_token"
            },
            "args": [
                "/path/to/linear-mcp/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

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

JSON

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

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": {
            "env": {
                "LINEAR_ACCESS_TOKEN": "your_personal_access_token"
            },
            "args": [
                "/path/to/linear-mcp/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

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

JSON

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

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": {
            "env": {
                "LINEAR_ACCESS_TOKEN": "your_personal_access_token"
            },
            "args": [
                "/path/to/linear-mcp/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

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

JSON

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

From the repository

1. Clone the repository
2. Install dependencies:

   npm install

3. Copy .env.example to .env:

   cp .env.example .env

The server supports two authentication methods:

1. Build the server:

   npm run build

2. Start the server:

   npm start

- 🚧 OAuth flow with automatic token refresh

npm install

`Create issues`

Create issues with full field support including title, description, team, project, etc.

`Update existing issues`

Update existing issues, allowing changes to priority, description, etc.

`Delete issues`

Delete issues, supporting both single and bulk deletion.

`Search issues`

Search for issues with various filtering options.

`Associate issues with projects`

Link issues to specific projects.

`Create parent/child issue relationships`

Establish relationships between parent and child issues.

`Create projects`

Create projects that can have associated issues.

`Get project information`

Retrieve detailed information about specific projects.

`Get team information`

Access information about teams, including states and workflow details.

`Access team states and labels`

Retrieve the states and labels associated with teams.

`Personal Access Token (PAT) authentication`

Authenticate using a Personal Access Token.

`Secure token storage`

Store authentication tokens securely.

`Bulk issue creation`

Create multiple issues in bulk.

`Bulk issue deletion`

Delete multiple issues in bulk.

`Bulk issue updates`

Perform bulk updates on issues (currently in testing).

Claude Desktop / Cursor

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

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

Linux

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

Macos

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

Windows

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

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:

Personal Access Token (Recommended)

1. Go to Linear: Settings > API > OAuth application > "Cline MCP"
2. Under "Developer Token", click "Create & copy token"
3. Select "Application"
3. Add the token to your .env file:

   LINEAR_ACCESS_TOKEN=your_personal_access_token

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_ACCESS_TOKEN": "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

Project Management

- ✅ Create projects with associated issues - ✅ Get project information - ✅ Associate issues with projects

Team Management

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

Authentication

- ✅ Personal Access Token (PAT) authentication - ✅ Secure token storage

Batch Operations

- ✅ Bulk issue creation - ✅ Bulk issue deletion

Bulk Updates (In Testing)

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

Features in Development

The following features are currently being worked on:

Issue Management

- 🚧 Comment functionality (add/edit comments, threading) - 🚧 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

5.0 · 1 review

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

Create issues

Update existing issues

Delete issues

Search issues

Associate issues with projects

Create parent/child issue relationships

Create projects

Get project information

Get team information

Access team states and labels

Personal Access Token (PAT) authentication

Secure token storage

Bulk issue creation

Bulk issue deletion

Bulk issue updates

Claude Desktop / Cursor

Linux

Macos

Windows

Linear MCP Server

Setup Guide

1. Environment Setup

2. Authentication

Personal Access Token (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)

Features in Development

Issue Management

Metadata Operations

Project Management

Authentication

Performance & Security

Development

Install

More like this

Time

Github SSE

Npx Y convex@latest mcp start

Inbox Zero

AWS MCP Servers

Lamda

`Create issues`

`Update existing issues`

`Delete issues`

`Search issues`

`Associate issues with projects`

`Create parent/child issue relationships`

`Create projects`

`Get project information`

`Get team information`

`Access team states and labels`

`Personal Access Token (PAT) authentication`

`Secure token storage`

`Bulk issue creation`

`Bulk issue deletion`

`Bulk issue updates`