drio
Open app

Linear MCP Server

Source

MCP server for Linear integration

Catalog onlyCatalog onlySTDIO

Overview

Linear MCP Server is a Model Context Protocol (MCP) server designed for Linear, enabling integration with Linear's API to manage teams, issues, projects, and cycles effectively.

To use the Linear MCP Server, install it through the Cline MCP Marketplace, configure your Linear credentials in the MCP configuration file, and verify the installation by testing the connection with the linear_search_issues tool.

  • Retrieve all teams with their states and labels using linear_get_teams. - Search for issues with filtering and pagination using linear_search_issues. - Get all cycles for a team using linear_get_cycles. - Get all projects using linear_get_projects. - Create and update issues with linear_create_issue and linear_update_issue tools.
  1. Managing team structures and states in Linear.
  2. Searching and filtering issues for better project management.
  3. Tracking project cycles and milestones.
  4. Creating and updating issues programmatically.

Add to your AI client

Use these steps to connect Linear MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear-mcp-server-cpropster"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear-mcp-server-cpropster"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear-mcp-server-cpropster"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "linear-mcp-server-cpropster": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear-mcp-server-cpropster"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear-mcp-server-cpropster"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-linear-mcp-server-cpropster"
      ]
    }
  }
}

FAQ

**What is required to run the Linear MCP Server?**

You need a Linear OAuth token and proper configuration in the MCP configuration file.

**Is there a verification step after installation?**

Yes, it is crucial to verify the connection to ensure the server is working properly.

**What programming language is used for the server?**

The server is built using TypeScript.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2266,"uuid":"5716d289-e5a9-4b2a-bc4c-10a2830ae101","name":"linear-mcp-server","title":"Linear MCP Server","description":"MCP server for Linear integration","avatar_url":"https://avatars.githubusercontent.com/u/56615488?v=4","created_at":"2025-03-09T07:15:52.285Z","updated_at":"2025-03-12T10:20:54.312Z","status":"created","author_name":"cpropster","author_avatar_url":"https://avatars.githubusercontent.com/u/56615488?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/cpropster/linear-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/a443f50d68d384fdfd4dece290e1f56b554124b18ab4a7d327ed20f96b2fe072/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436c696e652d4d43502532304d61726b6574706c6163652d626c7565","type":null,"metadata":"{\"star\":\"1\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-06 12:10:32\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools