Linear

by emmett-deen

3 stars

84 downloads

Not rated

GitHub Website

About

Integrates with Linear project management systems to retrieve and modify data related to users, teams, projects, and issues through the Linear GraphQL API.

Details

Author: emmett-deen
Repository: emmett-deen/Linear-MCP-Server
GitHub stars: 3
Downloads: 84
Categories: Productivity, Developer Tools, Design, Workplace, AI, Communication, Project Management, API, Other

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

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @emmett.deen/linear-mcp-server
Environment
- LINEAR_API_KEY your_linear_api_key_here
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_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

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_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

To install Linear MCP Server for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

After installation, add the following to your MCP settings file:

json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@emmett.deen/linear-mcp-server"],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}

- Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json - Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - GoMCP: ~/.config/gomcp/config.yaml 1. Clone the repository

bash
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Install dependencies

bash
npm install

3. Build the project

bash
npm run build

4. Create a .env file with your Linear API token

LINEAR_API_KEY=your_linear_api_key_here

5. Start the server

bash
npm start



npm install -g @emmett.deen/linear-mcp-server
git clone https://github.com/yourusername/Linear-MCP-Server.git

cd Linear-MCP-Server

npm install

npm link  # Makes the package available globally

Run the server with your Linear API token:

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

Or set the token in your environment and run without arguments:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

npm install

1. Clone the repository

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Install dependencies

npm install

3. Start in development mode

npm run dev

See TOOLS.md for a complete list of available tools and planned features.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "your_linear_api_key_here"
            },
            "args": [
                "-y",
                "@emmett.deen/linear-mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
    },
    "args": [
        "-y",
        "@emmett.deen/linear-mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
    },
    "args": [
        "-y",
        "@emmett.deen/linear-mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "@emmett.deen/linear-mcp-server"
    ],
    "command": "cmd"
}

Linear MCP Server

A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.

Features

Installation

Installing via Smithery (Recommended)

To install Linear MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

Manual Configuration

After installation, add the following to your MCP settings file:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@emmett.deen/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Client-Specific Configuration Locations

- Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
- Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- GoMCP: ~/.config/gomcp/config.yaml

Manual Installation

1. Clone the repository

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. Install dependencies

npm install

3. Build the project

npm run build

4. Create a .env file with your Linear API token

LINEAR_API_KEY=your_linear_api_key_here

5. Start the server

npm start

Available Tools

See TOOLS.md for a complete list of available tools and planned features.

Overview

Linear-MCP-Server bridges the gap between Claude (AI assistant) and Linear (project management tool) by implementing the MCP protocol. This allows Claude to:

- Retrieve issues, projects, teams, and other data from Linear
- Create and update issues
- Change issue status
- Assign issues to team members
- Add comments
- Create projects and teams

The server uses Linear's GraphQL API and authenticates via user tokens (not OAuth) for simplicity.

Getting Started

Prerequisites

- Node.js (v18+)
- NPM or Yarn
- Linear API token

Installation

```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

Linux

Macos

Windows

Linear MCP Server

Features

Installation

Installing via Smithery (Recommended)

Manual Configuration

Client-Specific Configuration Locations

Manual Installation

Available Tools

Overview

Getting Started

Prerequisites

Installation

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7