Linear MCP

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol (MCP) server specifically designed for Linear, a popular project management tool. It enables AI assistants to interact with and manage various aspects of Linear projects, initiatives, issues, users, teams, and states.

How to use Linear MCP Server?

To use Linear MCP Server, you need Node.js 18 or later and a Linear API key. After cloning the repository and installing dependencies, you can configure your Linear API key in a .env file. The server can be run in command-line (stdio) mode for CLI tools or as an HTTP server with Server-Sent Events (SSE) for remote connections. There's also a development mode with automatic reloading. For integration with Claude Desktop, specific configuration steps are provided to connect the server.

Key Features of Linear MCP Server

Resources

• Core Resources: Access to issues, teams, projects, users, and initiatives.
• Additional Resources: Access to roadmaps, milestones, documents, and integrations.
• Specialized Resources: Granular access to issues within specific teams, users, or projects, as well as team-specific workflow states, labels, cycles, members, and documents.

Tools

• Issue Management: Create, update, and add comments to issues.
• Project Management: Create and update projects, and add issues to projects.
• Initiative Management: Create initiatives, link, and unlink projects to initiatives.
• Search Capabilities: Comprehensive search across all Linear entities.

Prompts

• Issue Related: Templates for creating new issues, bug reports, and feature requests.
• Project Related: Templates for creating new projects, planning projects with issues, and generating project status updates.

Use Cases of Linear MCP Server

• AI-powered Project Management: Integrate AI assistants to automate tasks like issue creation, project updates, and progress tracking in Linear.
• Custom Integrations: Build custom applications or scripts that interact with Linear data and functionalities through the MCP protocol.
• Enhanced Workflow Automation: Automate complex workflows involving multiple Linear entities, such as linking projects to initiatives based on certain criteria.
• Reporting and Analytics: Extract and process Linear data for custom reporting and analytical purposes.

FAQ from Linear MCP Server

Q: What are the prerequisites for running Linear MCP Server? A: Node.js 18 or later and a Linear API key.

Q: How do I provide my Linear API key? A: Create a .env file in the project root with LINEAR_API_KEY=your_linear_api_key_here.

Q: Can I run the server as an HTTP service? A: Yes, you can run it using node dist/index.js http. The default port is 3000, which can be configured via the SERVER_PORT environment variable.

Q: How can I test the server? A: You can test it using the MCP Inspector by running npx @modelcontextprotocol/inspector stdio -- npm start or by connecting to your HTTP server in the MCP Inspector's browser interface.

Q: What Linear resources can I access through this server? A: You can access issues, teams, projects, users, initiatives, roadmaps, milestones, documents, integrations, and organization-level details, including specialized resources for team and project-specific data.

Linear MCP Server

A Model Context Protocol (MCP) server for Linear, providing AI assistants with access to Linear's project management capabilities.

Features

• Resources: Access issues, projects, teams, users, roadmaps, documents, initiatives, and more
• Tools: Create and update issues, manage projects, search, link projects to initiatives
• Prompts: Templates for issue creation, bug reports, feature requests, and more

Setup

Prerequisites

• Node.js 18 or later
• A Linear API key

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/linear-mcp.git
   cd linear-mcp
   

2. Install dependencies:

   npm install
   

3. Create a .env file with your Linear API key:

   LINEAR_API_KEY=your_linear_api_key_here
   

4. Build the project:

   npm run build
   

Usage

Command-line (stdio)

To run the server with stdio transport (for use with CLI tools that support MCP):

npm start

Or:

node dist/index.js stdio

HTTP Server (for remote connections)

To run the server as an HTTP service with Server-Sent Events (SSE):

node dist/index.js http

This will start an HTTP server on port 3000 (configurable via PORT environment variable).

Development Mode

To run in development mode with automatic reloading:

npm run dev

Claude Desktop Integration

To use this server with Claude Desktop:

1. Build the project:

   npm run build
   

2. In Claude Desktop, go to Settings → Advanced → MCP Configuration.

3. Add the following configuration (adjust paths to match your installation):

   {
     "mcpServers": {
       "linear": {
         "command": "node",
         "args": [
           "/path/to/linear-mcp/dist/index.js"
         ],
         "env": {
           "LINEAR_API_KEY": "your_linear_api_key_here"
         }
       }
     }
   }
   

4. Save the configuration and restart Claude Desktop.

Alternatively, you can copy the provided claude-desktop-config.json file and modify the paths to match your installation.

Resources

The server provides access to all major Linear entities as resources:

Core Resources

• Issues: linear://issues and linear://issues/{id}
• Teams: linear://teams and linear://teams/{id}
• Projects: linear://projects and linear://projects/{id}
• Users: linear://users and linear://users/{id}
• Initiatives: linear://initiatives and linear://initiatives/{id}

Additional Resources

• Roadmaps: linear://roadmaps and linear://roadmaps/{id}
• Milestones: linear://milestones and linear://milestones/{id}
• Documents: linear://documents and linear://documents/{id}
• Integrations: linear://integrations and linear://integrations/{id}
• Organization: linear://organization

Specialized Resources

• linear://teams/{teamId}/issues - Issues for a specific team
• linear://users/{userId}/issues - Issues assigned to a specific user
• linear://projects/{projectId}/issues - Issues in a specific project
• linear://teams/{teamId}/states - Workflow states for a team
• linear://teams/{teamId}/labels - Labels for a team
• linear://teams/{teamId}/cycles - Cycles for a team
• linear://teams/{teamId}/members - Members of a team
• linear://teams/{teamId}/documents - Documents for a team
• linear://projects/{projectId}/documents - Documents for a project
• linear://projects/{projectId}/initiative - Initiative associated with a project
• linear://initiatives/{initiativeId}/projects - Projects associated with an initiative
• linear://milestones/{milestoneId}/projects - Projects for a milestone
• linear://organization/subscription - Organization subscription details
• linear://organization/auth-services - Organization authentication services
• linear://integration-services - Available integration services

Tools

The server provides tools for:

• Issue Management

  • Creating new issues
  • Updating existing issues
  • Adding comments to issues

• Project Management

  • Creating new projects
  • Updating existing projects
  • Adding issues to projects

• Initiative Management

  • Creating initiatives
  • Linking projects to initiatives
  • Unlinking projects from initiatives

• Search Capabilities

  • Comprehensive search across Linear entities
  • Finding issues with specific criteria

Prompts

The server provides prompt templates for:

• Issue Related

  • Creating new issues
  • Creating bug reports
  • Creating feature requests

• Project Related

  • Creating new projects
  • Planning projects with issues
  • Creating project status updates

Testing

Test with the MCP Inspector:

npx @modelcontextprotocol/inspector stdio -- npm start

Or, if running in HTTP mode, open the MCP Inspector in your browser and connect to your server's URL.

Environment Variables

• LINEAR_API_KEY (required): Your Linear API key
• SERVER_PORT (optional): Port for HTTP server (default: 3000)
• LOG_LEVEL (optional): Logging level (default: info)

License

MIT