MCP Server Linear

🚀 mcp-server-linear

This is an MCP server tool that defines interactions with Linear. Through this MCP server, you can use the client to operate Linear.

🚀 Quick Start

This project uses Bun and can be directly run via Bun without transpilation (this is my common way). To run it with Bun, use the following command:

bun run index.ts

Of course, you can also run it with Node. To run it with Node, use the following command:

node build/index.js

✨ Features

Current Features

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

Planned Features

• 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 new project (in Linear)
• linear-update-project: Update a project (in Linear)

Planned Resources

• linear-issue:///{issueId} - View detailed information of a single issue
• linear-project:///{projectId} - View detailed information of a project
• linear-cycle:///{cycleId} - View detailed information of a cycle (default is the current cycle)
• linear-team:///{teamId}/issues - View team issues
• linear-user:///{userId}/assigned - View user - assigned issues
• linear-organization: - View organization information

📦 Installation

Compile to a Stand - Alone Executable

Bun projects can be compiled into stand - alone executables. In this way, you can run the server without installing Bun (theoretically). To compile this project into a stand - alone executable, use the following command:

bun build:standalone

You may need to adjust the target of the build according to the target machine. Refer to the Bun documentation for more details.

Add to Your MCP Client via JSON

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

When Running with Bun

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

When Running with Node

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

Stand - Alone Executable

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

📄 License

This project is under the MIT license.

Acknowledgments

This project is inspired by jerhadf/linear-mcp-server. Some problems encountered by me and others prompted me to create my own implementation. The feature list of that project is worth keeping.