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