Integrations
Allows AI agents to manage issues, projects, and teams in Linear. Provides tools for creating, listing, and updating issues, as well as listing teams and projects through the Linear API.
Linear MCP Server
Note: This is a custom implementation. For the official Cline Linear MCP server, see cline/linear-mcp.
A Model Context Protocol (MCP) server that provides tools for interacting with Linear's API, enabling AI agents to manage issues, projects, and teams programmatically through the Linear platform.
Features
- Issue Management
- Create new issues with customizable properties (title, description, team, assignee, priority, labels)
- List issues with flexible filtering options (team, assignee, status)
- Update existing issues (title, description, status, assignee, priority)
- Team Management
- List all teams in the workspace
- Access team details including ID, name, key, and description
- Project Management
- List all projects with optional team filtering
- View project details including name, description, state, and associated teams
Prerequisites
- Node.js (v16 or higher)
- A Linear account with API access
- Linear API key with appropriate permissions
Quick Start
- Get your Linear API key from Linear's Developer Settings
- Run with your API key:
Or set it in your environment:
Development Setup
- Clone the repository:
- Install dependencies:
- Build the project:
Running with Inspector
For local development and debugging, you can use the MCP Inspector:
- Install supergateway:
- Use the included
run.sh
script:
- Access the Inspector:
- Open localhost:1337 in your browser
- The Inspector connects via Server-Sent Events (SSE)
- Test and debug tool calls through the Inspector interface
Configuration
Configure the MCP server in your settings file based on your client:
For Claude Desktop
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
For VS Code Extension (Cline)
Location: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
For Cursor (cursor.sh)
For Cursor, the server must be run with the full path:
Available Tools
create_issue
Creates a new issue in Linear.
list_issues
Lists issues with optional filters.
update_issue
Updates an existing issue.
list_teams
Lists all teams in the workspace. No parameters required.
list_projects
Lists all projects with optional filtering.
get_issue
Gets detailed information about a specific issue.
Development
For development with auto-rebuild:
Error Handling
The server includes comprehensive error handling for:
- Invalid API keys
- Missing required parameters
- Linear API errors
- Invalid tool requests
All errors are properly formatted and returned with descriptive messages.
Technical Details
Built with:
- TypeScript
- Linear SDK (@linear/sdk v37.0.0)
- MCP SDK (@modelcontextprotocol/sdk v0.6.0)
The server uses stdio for communication and implements the Model Context Protocol for seamless integration with AI agents.
License
MIT
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.
Enables interaction with Linear's API for managing issues, teams, and projects programmatically through the Model Context Protocol.
- Features
- Prerequisites
- Quick Start
- Development Setup
- Running with Inspector
- Configuration
- Available Tools
- Development
- Error Handling
- Technical Details
- License
Related Resources
Related MCP Servers
- -securityFlicense-qualityFacilitates project management with the Linear API via the Model Context Protocol, allowing users to manage initiatives, projects, issues, and their relationships through features like creation, viewing, updating, and prioritization.Last updated -3244TypeScript
- -securityAlicense-qualityA Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.Last updated -151TypeScriptMIT License
- -securityFlicense-qualityA server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.Last updated -TypeScript
- -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 -15MIT License