Linear Project

stdio

Scope-gated Linear project administration with optional GitHub and Obsidian evidence adapters

Getting Started

npx @getmcp/cli add org.openlyuseful/linear-project

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

LINEAR_ALLOWED_ORGANIZATION_ID
Exact Linear organization ID allowed for scoped operations.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "org.openlyuseful/linear-project": {
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "",
        "LINEAR_ACCESS_TOKEN": "",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "",
        "LINEAR_ALLOWED_TEAM_IDS": "",
        "LINEAR_ALLOWED_PROJECT_IDS": "",
        "LINEAR_ALLOWED_SCOPE_CODES": "",
        "GITHUB_TOKEN": "",
        "GITHUB_ALLOWED_REPOSITORIES": "",
        "OBSIDIAN_VAULT_PATH": "",
        "OBSIDIAN_VAULT_NAME": "",
        "OBSIDIAN_ALLOWED_DIRECTORIES": "",
        "MCP_WRITES_ENABLED": "false",
        "MCP_WRITE_WINDOW_EXPIRES_AT": "",
        "MCP_AUDIT_LOG_PATH": ""
      }
    }
  }
}

Claude Desktop MCP documentation