Linear

by floodfx

1 stars

Not rated

GitHub

About

Integrates with Linear project management tool to search for issues with detailed filtering by team, status, assignee, labels, project, priority, and more.

Details

Author: floodfx
Repository: floodfx/mcp-server-linear
GitHub stars: 1
License: MIT License
Categories: Developer Tools, Design, Workplace, AI, Search, Project Management, Communication, Frontend, Infrastructure

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.) bun
Arguments
- Argument 1 run
- Argument 2 /path/to/linear-mcp-server/index.ts
Environment
- LINEAR_API_KEY lin_api_ABCD
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": "lin_api_ABCD"
            },
            "args": [
                "run",
                "/path/to/linear-mcp-server/index.ts"
            ],
            "command": "bun"
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "lin_api_ABCD"
            },
            "args": [],
            "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server"
        }
    }
}

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": "lin_api_ABCD"
            },
            "args": [
                "run",
                "/path/to/linear-mcp-server/index.ts"
            ],
            "command": "bun"
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "lin_api_ABCD"
            },
            "args": [],
            "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server"
        }
    }
}

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": "lin_api_ABCD"
            },
            "args": [
                "run",
                "/path/to/linear-mcp-server/index.ts"
            ],
            "command": "bun"
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "lin_api_ABCD"
            },
            "args": [],
            "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server"
        }
    }
}

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": "lin_api_ABCD"
            },
            "args": [
                "run",
                "/path/to/linear-mcp-server/index.ts"
            ],
            "command": "bun"
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "lin_api_ABCD"
            },
            "args": [],
            "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server"
        }
    }
}

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": "lin_api_ABCD"
            },
            "args": [
                "run",
                "/path/to/linear-mcp-server/index.ts"
            ],
            "command": "bun"
        }
    }
}

JSON

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

JSON

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "lin_api_ABCD"
            },
            "args": [],
            "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server"
        }
    }
}

`linear-search-issues`

Search for issues in Linear.

`linear-create-issue`

Create an issue in Linear.

`linear-update-issue`

Update an issue in Linear.

`linear-get-issue`

Get an issue in Linear.

`linear-get-project-issues`

Get all issues in a project in Linear.

`linear-add-comment`

Add a comment to an issue in Linear.

`linear-create-project`

Create a project in Linear.

`linear-update-project`

Update a project in Linear.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "linear": {
            "env": {
                "LINEAR_API_KEY": "lin_api_ABCD"
            },
            "args": [
                "run",
                "/path/to/linear-mcp-server/index.ts"
            ],
            "command": "bun"
        }
    }
}

Linux

{
    "env": {
        "LINEAR_API_KEY": "lin_api_ABCD"
    },
    "args": [],
    "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server"
}

Macos

{
    "env": {
        "LINEAR_API_KEY": "lin_api_ABCD"
    },
    "args": [
        "run",
        "/path/to/linear-mcp-server/index.ts"
    ],
    "command": "bun"
}

Windows

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

mcp-server-linear

This is a MCP server that defines tools for interacting with Linear via an MCP client.

Current Tools

- linear-search-issues: Search for issues in Linear

Future Tools

- linear-create-issue: Create an issue in Linear
- linear-update-issue: Update an issue in Linear
- linear-get-issue: Get an issue in Linear
- linear-get-project-issues: Get all issues in a project in Linear
- linear-add-comment: Add a comment to an issue in Linear
- linear-create-project: Create a project in Linear
- linear-update-project: Update a project in Linear

Future Resources

- linear-issue:///{issueId} - View individual issue details
- linear-project:///{projectId} - View project details
- linear-cycle:///{cycleId} - View cycle details (defaults to current cycle)
- linear-team:///{teamId}/issues - View team issues
- linear-user:///{userId}/assigned - View user's assigned issues
- linear-organization: - View organization info

Bun-preferred

This project uses Bun and can be run directly from Bun without transpiling (which is how I use it). To run it with Bun, you can use the following command:

bun run index.ts

That said, you can run it with Node if you prefer. To run it with Node, you can use the following command:

node build/index.js

Standalone Executable

Bun projects can be compiled into standalone executable. This allows you to run the server without having to install Bun (theoretically). To compile the project into a standalone executable, you can use the following command:

bun build:standalone

You may need to change the build target depending on the machine you are building for. See Bun docs for more details.

Adding to your MCP client via JSON

To add this server to your MCP client, you can use the following JSON configuration:

Bun Runtime

"linear": {
  "command": "bun",
  "args": [
    "run",
    "/path/to/linear-mcp-server/index.ts"
  ],
  "env": {
    "LINEAR_API_KEY": "lin_api_ABCD"
  }
}

Node Runtime

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

Standalone Executable

"linear": {
  "command": "/path/to/linear-mcp-server/standalone-linear-mcp-server",
  "args": [],
  "env": {
    "LINEAR_API_KEY": "lin_api_ABCD"
  }
}

Credits

This project was inspired by jerhadf/linear-mcp-server. I and others had trouble getting it to work, which prompted me to create my own implementation. The list of tools and resources seemed worth keeping.

License

MIT

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

linear-search-issues

linear-create-issue

linear-update-issue

linear-get-issue

linear-get-project-issues

linear-add-comment

linear-create-project

linear-update-project

Claude Desktop / Cursor

Linux

Macos

Windows

mcp-server-linear

Current Tools

Future Tools

Future Resources

Bun-preferred

Standalone Executable

Adding to your MCP client via JSON

Bun Runtime

Node Runtime

Standalone Executable

Credits

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`linear-search-issues`

`linear-create-issue`

`linear-update-issue`

`linear-get-issue`

`linear-get-project-issues`

`linear-add-comment`

`linear-create-project`

`linear-update-project`