What is Mcp Server Linear

mcp-server-linear is a server designed for interacting with Linear through an MCP client, providing various tools for issue and project management.

Use cases

Use cases include managing project issues, tracking team assignments, creating and updating projects, and integrating Linear functionalities into other applications.

How to use

To use mcp-server-linear, you can run it using Bun or Node.js. For Bun, use ‘bun run index.ts’. For Node.js, use ‘node build/index.js’. It can also be compiled into a standalone executable.

Key features

Key features include tools for searching, creating, updating, and retrieving issues and projects in Linear, as well as adding comments and viewing detailed information about issues, projects, cycles, teams, and users.

Where to use

mcp-server-linear can be used in software development environments where project management and issue tracking are essential, particularly for teams using Linear.

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

Node Runtime

Standalone Executable

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