Linear

by skspade

3 stars

342 downloads

Not rated

GitHub

About

Integrates with Linear's project management platform to enable querying, creating, and updating sprint issues across teams using TypeScript and the Linear SDK.

Details

Author: skspade
Repository: skspade/mcp-linear-server
GitHub stars: 3
Downloads: 342
Categories: Productivity, Developer Tools, Design, Workplace, AI, Search, Project Management, Communication, Frontend
Tags: #integration

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 @highlight/mcp-server
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": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "-y",
                "@highlight/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": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "-y",
                "@highlight/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": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "-y",
                "@highlight/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": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "-y",
                "@highlight/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": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

1. Get your Linear API key from Linear's settings > API section
2. Create a .env file in the project root:

LINEAR_API_KEY=your_api_key_here

3. Install dependencies:

npm install

4. Start the server:
```bash

This server can be deployed on Smithery.ai using the provided configuration files:

1. Add this repository to Smithery or claim an existing server
2. Access the Deployments tab (authenticated owners only)
3. Configure the deployment with your Linear API key
4. Deploy the server

The repository includes two essential files for Smithery deployment:

1. Dockerfile: Defines the server build process
- Uses Node.js 18 Alpine as the base image
- Installs dependencies and builds the TypeScript code
- Sets up the command to run the server

2. smithery.yaml: Defines the server startup configuration
- Specifies the command to run the server
- Defines the required configuration parameters (Linear API key)
- Handles environment variable setup

`linear_create_issue`

Creates a new Linear issue with the specified title, team ID, description, priority, and status.

`linear_search_issues`

Search Linear issues with flexible filtering based on query, team ID, status, assignee ID, priority, limit, cursor, sortBy, and sortDirection.

`linear_sprint_issues`

Get all issues in the current sprint/iteration for a specified team ID.

`linear_search_teams`

Search and retrieve Linear teams based on a query in team names.

`linear_filter_sprint_issues`

Filter current sprint issues by status, automatically filtering to the current user for a specified team ID.

`linear_get_issue_details`

Get detailed information about a specific issue using its issue ID.

`linear_bulk_update_status`

Update the status of multiple Linear issues at once using a list of issue IDs and a target status.

`linear_manage_cycle`

Create, update, or get information about Linear cycles (sprints) based on the specified action, team ID, cycle ID, name, start date, end date, and description.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "linear": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Linear MCP Integration Server

This server provides Linear integration capabilities through the Model Context Protocol (MCP). It allows AI models to interact with Linear for issue tracking and project management.

Features

The server provides the following tools through the MCP interface:

linear_create_issue

Creates a new Linear issue with the following parameters: - title (required): Issue title - teamId (required): Team ID to create issue in - description (optional): Issue description (markdown supported) - priority (optional): Priority level (0-4) - status (optional): Initial status name

linear_search_issues

Search Linear issues with flexible filtering and pagination support: - query (optional): Text to search in title/description - teamId (optional): Filter by team - status (optional): Filter by status - assigneeId (optional): Filter by assignee - priority (optional): Priority level (0-4) - limit (optional, default: 10): Max results per page - cursor (optional): Pagination cursor for fetching next page - sortBy (optional, default: 'updated'): Field to sort by ('created', 'updated', 'priority', 'title') - sortDirection (optional, default: 'desc'): Sort direction ('asc', 'desc')

linear_sprint_issues

Get all issues in the current sprint/iteration: - teamId (required): Team ID to get sprint issues for

linear_search_teams

Search and retrieve Linear teams: - query (optional): Text to search in team names

linear_filter_sprint_issues

Filter current sprint issues by status and automatically filters to the current user: - teamId (required): Team ID to get sprint issues for - status (required): Status to filter by (e.g. "Pending Prod Release")

linear_get_issue_details

Get detailed information about a specific issue, including full description, comments, and metadata: - issueId (required): Issue ID (e.g., "DATA-1284") to fetch details for

linear_bulk_update_status

Update the status of multiple Linear issues at once: - issueIds (required): List of issue IDs to update (e.g. ["ENG-123", "DATA-456"]) - targetStatus (required): Target status to set for all issues (e.g. "In Progress")

linear_manage_cycle

Create, update, or get information about Linear cycles (sprints): - action (required): Action to perform: "create", "update", "get", or "list" - teamId (required): Team ID to manage cycles for - cycleId (optional, required for update and get actions): Cycle ID - name (optional, required for create): Cycle name - startDate (optional, required for create): Start date in ISO format (YYYY-MM-DD) - endDate (optional, required for create): End date in ISO format (YYYY-MM-DD) - description (optional): Cycle description

Developer Setup

1. Get your Linear API key from Linear's settings > API section
2. Create a .env file in the project root:

LINEAR_API_KEY=your_api_key_here

3. Install dependencies:

npm install

4. Start the server:
```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

linear_create_issue

linear_search_issues

linear_sprint_issues

linear_search_teams

linear_filter_sprint_issues

linear_get_issue_details

linear_bulk_update_status

linear_manage_cycle

Claude Desktop / Cursor

Linux

Macos

Windows

Linear MCP Integration Server

Features

linear_create_issue

linear_search_issues

linear_sprint_issues

linear_search_teams

linear_filter_sprint_issues

linear_get_issue_details

linear_bulk_update_status

linear_manage_cycle

Developer Setup

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`linear_create_issue`

`linear_search_issues`

`linear_sprint_issues`

`linear_search_teams`

`linear_filter_sprint_issues`

`linear_get_issue_details`

`linear_bulk_update_status`

`linear_manage_cycle`