https://github.com/floodfx/mcp-server-linear
https://github.com/floodfx/mcp-server-linear
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/floodfx/mcp-server-linear
- Owner: floodfx
- License: mit
- Created: 2025-03-07T16:57:37.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-07T16:58:18.000Z (3 months ago)
- Last Synced: 2025-03-09T23:48:51.486Z (3 months ago)
- Language: TypeScript
- Size: 398 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- mcp-index - Linear MCP Server - Interact with Linear for searching, creating, and managing issues and projects. Provides tools for issue tracking and project management within applications. (Task and Project Management)
README
# 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:
```bash
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:
```bash
node build/index.js
```
## Standalone Executable
Bun projects can be [compiled into standalone executable](https://bun.sh/docs/bundler/executables). 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:
```bash
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
```json
"linear": {
"command": "bun",
"args": [
"run",
"/path/to/linear-mcp-server/index.ts"
],
"env": {
"LINEAR_API_KEY": "lin_api_ABCD"
}
}
```
### Node Runtime
```json
"linear": {
"command": "node",
"args": [
"/path/to/linear-mcp-server/build/index/js"
],
"env": {
"LINEAR_API_KEY": "lin_api_ABCD"
}
}
```
### Standalone Executable
```json
"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](https://github.com/jerhadf/linear-mcp-server). [I and others had trouble getting it to work](https://github.com/jerhadf/linear-mcp-server/issues/5), which prompted me to create my own implementation. The list of tools and resources seemed worth keeping.
## License
MIT