Linear MCP Server

What does “Linear” MCP Server do?

The Linear MCP (Model Context Protocol) Server acts as an interface between AI assistants and Linear, a popular project management tool. By exposing Linear’s rich set of resources—such as issues, projects, teams, and users—through the MCP protocol, it empowers AI clients to automate, query, and manage project workflows efficiently. This server enables tasks such as creating and updating issues, managing projects, searching across entities, and linking initiatives, making it ideal for streamlining software development, project tracking, and team collaboration. By leveraging Linear MCP, developers and AI agents can seamlessly integrate project management operations into their development workflows, reducing manual effort and improving productivity.

List of Prompts

• Creating new issues
  Template prompt to standardize and guide the creation of new Linear issues.
• Creating bug reports
  Template for submitting detailed bug reports with required fields.
• Creating feature requests
  Prompt template for proposing and detailing new features.
• Creating new projects
  Template for initiating new projects in Linear.
• Planning projects with issues
  Prompt for organizing and planning projects by associating relevant issues.
• Creating project status updates
  Template for submitting routine or milestone-based status updates for projects.

List of Resources

• Issues:
  Access and manage Linear issues (linear://issues, linear://issues/{id}).
• Projects:
  Retrieve and manipulate project data (linear://projects, linear://projects/{id}).
• Teams:
  View and organize teams (linear://teams, linear://teams/{id}).
• Users:
  Access user data (linear://users, linear://users/{id}).
• Initiatives, Roadmaps, Documents, Milestones, Integrations, Organization:
  Comprehensive access to all major Linear entities and their relationships.

List of Tools

• Issue Management:
  Create, update, and comment on Linear issues.
• Project Management:
  Create and update projects, add issues to projects.
• Initiative Management:
  Create initiatives, link/unlink projects to initiatives.
• Search Capabilities:
  Search across all Linear entities and find issues with specific criteria.

Use Cases of this MCP Server

• Automated Issue Tracking:
  AI assistants can create, update, and comment on issues, ensuring timely tracking and documentation of tasks and bugs.
• Project and Sprint Planning:
  Automate creation and organization of projects, assign issues, and manage team workloads within Linear.
• Initiative and Roadmap Management:
  Link projects to strategic initiatives, update progress, and ensure alignment with business goals.
• AI-driven Bug Reporting:
  Standardize and expedite the process of logging and triaging bugs directly from conversational agents.
• Real-time Project Status Updates:
  Generate and update project status reports, keeping all stakeholders informed.

How to set it up

Windsurf

1. Prerequisites:
   • Node.js 18+
   • Linear API key
2. Clone and install:
   • git clone https://github.com/anoncam/linear-mcp.git
   • cd linear-mcp
   • npm install
3. Build project:
   • npm run build
4. Configure Windsurf:
   • Add the following JSON snippet to your Windsurf MCP configuration:

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

5. Restart Windsurf and verify setup.

Securing API Keys

It is recommended to store sensitive API keys in environment variables. Example:

"env": {
  "LINEAR_API_KEY": "${LINEAR_API_KEY}"
}

Claude

1. Prerequisites:
   • Node.js 18+
   • Linear API key
2. Build project:
   • npm run build
3. Open Claude Desktop > Settings > Advanced > MCP Configuration.
4. Add MCP server configuration:

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

5. Save and restart Claude Desktop.

Securing API Keys

Store API keys in environment variables:

"env": {
  "LINEAR_API_KEY": "${LINEAR_API_KEY}"
}

Cursor

1. Prerequisites:
   • Node.js 18+
   • Linear API key
2. Clone, install, and build:
   • git clone https://github.com/anoncam/linear-mcp.git
   • cd linear-mcp
   • npm install
   • npm run build
3. Edit Cursor MCP configuration:

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

4. Restart Cursor and verify.

Securing API Keys

Use environment variables:

"env": {
  "LINEAR_API_KEY": "${LINEAR_API_KEY}"
}

Cline

1. Prerequisites:
   • Node.js 18+
   • Linear API key
2. Clone, install, and build:
   • git clone https://github.com/anoncam/linear-mcp.git
   • cd linear-mcp
   • npm install
   • npm run build
3. Configure Cline with MCP server:

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

4. Restart Cline and verify.

Securing API Keys

Store API keys securely:

"env": {
  "LINEAR_API_KEY": "${LINEAR_API_KEY}"
}

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "linear": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “linear” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the information available, the Linear MCP server provides a comprehensive, well-documented integration for Linear with all major MCP features, but lacks explicit documentation for Roots and Sampling support. The setup is straightforward and covers security best practices.

MCP Score

Rating:
I’d rate this MCP server a 7/10. It has excellent coverage of Linear’s resources, tools, and prompt templates, and offers clear setup and security instructions. However, it lacks explicit support/info for Roots, Sampling, and is missing a LICENSE, which slightly reduces its production readiness and openness.