mcp-server-linear

What is mCP-server-linear?

mcp-server-linear is an MCP (Model Context Protocol) server that provides tools for interacting with Linear, a project management platform. It is designed to be used with any MCP-compatible client, allowing users to search issues in Linear directly from their MCP environment.

How to use mCP-server-linear?

Add the server to your MCP client using a JSON configuration that specifies the runtime (Bun or Node) and the LINEAR_API_KEY environment variable. You can run it directly with bun run index.ts or with node build/index.js after building. Optionally, compile it into a standalone executable with bun build:standalone.

Key features of mCP-server-linear

• Currently supports searching Linear issues via the linear-search-issues tool.
• Future tools will allow creating, updating, and reading issues and projects.
• Future resources will expose issues, projects, cycles, teams, and user data.
• Runs with Bun natively (preferred) or with Node after transpiling.
• Can be compiled into a standalone executable for portability.

Use cases of mCP-server-linear

• Search for specific issues in Linear from an MCP client without leaving your chat interface.
• (Future) Automate issue creation, updates, and comment additions through an MCP agent.
• (Future) Retrieve details of Linear projects, cycles, and team boards programmatically.
• Integrate Linear data into AI‑powered workflows that use MCP for context.

FAQ from mCP-server-linear

What runtime does mCP-server-linear require?

Bun is recommended because the server can be run directly without transpiling. Node is also supported after building the project with node build/index.js.

How do I configure my Linear API key?

Set the LINEAR_API_KEY environment variable in the MCP client’s JSON configuration, for example: `"env": { "LINEAR_API_KEY": "lin_api_ABCD" }