Integrations
Provides tools for searching, reading, updating, and commenting on issues in Linear's issue tracking system.
Linear MCP Server
A Node.js implementation of an MCP server for Linear integration.
About
This MCP (Model Context Protocol) server provides a standardized interface for AI models to interact with Linear issue tracking functionality.
Key Features
- Standard MCP protocol implementation for Linear using the official MCP SDK
- Support for searching issues, reading details, updating, and commenting
Getting Started
Prerequisites
- Node.js (v18 or later)
- Linear API key
Installation
- Clone the repository
- Install dependencies
- Create a
.env
file in the root directory with your Linear API key
Running the Server
Start the server:
For development with file watching:
For development with debug logging:
Or set environment variables manually:
Logs will be written to the logs/mcp-linear.log
file to avoid interfering with the STDIO transport.
Using with MCP Inspector
The server runs in stdio mode, which means you can connect to it with the MCP Inspector.
- Start the server in one terminal:
- Visit the web-based inspector at: https://inspector.modelcontextprotocol.ai
- Select "stdio" as the transport type
- Enter the following command:
- Click "Connect" to connect to your running server
Usage with Claude Desktop
Add the following to your Claude Desktop configuration file (typically at
~/.config/Claude Desktop/claude_desktop_config.json
):
Usage with Cursor
For Cursor, add the following to your settings:
Testing Your Integration
To verify your setup:
- Configure the MCP server in your Claude Desktop or Cursor settings
- Restart your application
- Ask: "Search for Linear issues containing 'bug'"
- The assistant should detect and use the Linear MCP server to retrieve results
Project Structure
Available Tools
The MCP server exposes the following tools:
list_issues
- List Linear issues (also called tickets) with various filtering options (assignee, status, etc.)get_issue
- Get detailed information about a specific Linear issue by IDlist_members
- List Linear team members with optional filtering by namelist_projects
- List Linear projects with optional filtering by team, name, and archive statusget_project
- Get detailed information about a specific Linear project including issues, members and morelist_teams
- List Linear teams with details about their members, projects, and issuesadd_comment
- Add a comment to a specific Linear issuecreate_issue
- Create a new issue in Linear with customizable title, description, priority, and assignee
For backward compatibility, the following tool aliases are also available:
list_tickets
- Alias forlist_issues
get_ticket
- Alias forget_issue
Troubleshooting
If you're having issues with the Linear MCP server:
- Check your Linear API key: Make sure you've set a valid Linear API key in your .env file or environment variables. Linear API keys should start with "linapi".
- Enable debug logging:a. When starting the MCP server:b. In your client configuration (Claude Desktop, Cursor, etc.):Copyc. When calling tools directly, add the debug parameter:CopyCopy
- Check log files: Examine logs in the
logs/mcp-linear.log
file for detailed error information. - Verify Linear API access: Make sure your Linear API key has appropriate permissions and that you can access the Linear API directly.
Architecture
The application follows an effects-based architecture:
- Effects: Side-effecting operations are isolated in the
effects
directory:linear
: Provides access to Linear API using the official Linear SDKlogging
: Safe logging that doesn't interfere with STDIO transport
- Tools: MCP tool implementations that use effects for side-effects:
- Each tool follows a consistent pattern with input validation using Zod
- Tools are exposed through the MCP protocol via the server
- Each tool can access the Linear client through the linear effect
- Utils: Utility modules for configuration and common functionality
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
You must be authenticated.
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.
A Deno implementation that enables AI models to interact with Linear issue tracking functionality, supporting searching issues, reading details, updating, and commenting.
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI agents to manage issues, projects, and teams on the Linear platform programmatically.Last updated -712322JavaScriptMIT License
- AsecurityAlicenseAqualityEnables AI integrations with ClickUp tasks, supporting resource management, task operations, workspace organization, and AI-powered task recommendations through a standardized protocol.Last updated -1820389TypeScriptMIT License
- -securityFlicense-qualityEnables AI models to interact with Linear for issue tracking and project management through capabilities like creating/searching issues, managing sprints, and retrieving workflow states.Last updated -TypeScript
- -securityFlicense-qualityEnables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.Last updated -JavaScript