This server allows you to interact with Linear via an MCP client.
- Search Issues: Search for issues using filters such as query, labels, status, team ID, project name, estimate points, priority, assignee ID, and include archived issues.
- Future Tools: Planned features include creating, updating, and fetching issues, managing projects, adding comments, and cycle management.
- Future Resources: Will provide access to issue details, project information, cycle details, team issues, user-assigned issues, and organization info.
- Runtime Options: Can be run using Bun, Node, or as a standalone executable.
- Configuration: Easy integration with MCP client via JSON configuration.
Provides runtime and build support for the MCP server, enabling execution without transpilation and allowing compilation into standalone executables for easier deployment.
Provides tools for interacting with Linear's issue tracking system, allowing users to search for issues with various filters including assignee, labels, priority, and status. Future capabilities include creating and updating issues, managing projects, adding comments, and accessing detailed information about issues, projects, cycles, teams, and users.
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 Linearlinear-update-issue
: Update an issue in Linearlinear-get-issue
: Get an issue in Linearlinear-get-project-issues
: Get all issues in a project in Linearlinear-add-comment
: Add a comment to an issue in Linearlinear-create-project
: Create a project in Linearlinear-update-project
: Update a project in Linear
Future Resources
linear-issue:///{issueId}
- View individual issue detailslinear-project:///{projectId}
- View project detailslinear-cycle:///{cycleId}
- View cycle details (defaults to current cycle)linear-team:///{teamId}/issues
- View team issueslinear-user:///{userId}/assigned
- View user's assigned issueslinear-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:
That said, you can run it with Node if you prefer. To run it with Node, you can use the following command:
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:
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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that provides tools for interacting with Linear issue tracking system, currently supporting issue search with plans to expand to issue creation, updates, comments, and project management.
- Current Tools
- Future Tools
- Bun-preferred
- Standalone Executable
- Adding to your MCP client via JSON
- Credits
- License
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.Last updated -636316JavaScriptMIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates with Backlog API, enabling project management operations including issues, projects, and wikis through natural language interactions.Last updated -12533TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.Last updated -3264994TypeScriptMIT License
- -securityAlicense-qualityProvides access to Linear's issue tracking system through a standardized Model Context Protocol interface, allowing users to create, update, search, and manage issues, projects, and comments via natural language.Last updated -191MIT License