Installation - ComfyUI MCP

1. Install ComfyUI

ComfyUI Desktop

The easiest way to get a managed install on macOS / Windows.

From source

Clone and run manually — or use the install_comfyui tool.

2. Add the MCP server

ComfyUI MCP ships on npm as comfyui-mcp and runs via npx — no global install needed.

Local ComfyUI
Remote ComfyUI
Comfy Cloud

The server auto-detects a local install and its port. Add it to ~/.claude/settings.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"]
    }
  }
}

Point at any reachable instance with --comfyui-url. No local install is required for HTTP-based tools (generation, queue, workflows, models search, etc.). When the host is non-loopback, the server enters remote mode and skips COMFYUI_PATH auto-detection so a stale local install can’t silently absorb uploads.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp", "--comfyui-url", "https://my-comfy.example.com"]
    }
  }
}

Local-only tools (installing ComfyUI/custom nodes, removing model files, reading logs) need a local install path and will return a clear error in remote mode. See How it works.

Target Comfy Cloud by setting COMFYUI_API_KEY. The server enters cloud mode: HTTP primitives route via cloud.comfy.org with X-API-Key authentication. WebSocket-bound and local-FS/process tools throw a clear CLOUD_UNSUPPORTED error.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "COMFYUI_API_KEY": "your-comfy-cloud-api-key"
      }
    }
  }
}

Cloud mode skips local COMFYUI_PATH auto-detection and uses the cloud’s own model library — list_local_models, apply_manifest, and other local-only tools throw CLOUD_UNSUPPORTED. See the Configuration page for the full feature-parity matrix.

Cloud-only? Comfy-Org’s Comfy Cloud MCP (public beta) is the canonical choice — see Local vs. Comfy Cloud. Use comfyui-mcp’s cloud-mode if you want a single MCP across local / remote / cloud, or you need cloud support today.

Then run /mcp in Claude Code to connect.

3. (Optional) Tokens

Some tools use API tokens. Set them in the server’s env block (see Configuration):

CIVITAI_API_TOKEN — gated CivitAI downloads
HUGGINGFACE_TOKEN — higher HuggingFace rate limits
GITHUB_TOKEN — skill generation / node metadata fetches
COMFY_API_KEY — hosted comfy.org API nodes

Local development

The project uses npm link so npx comfyui-mcp resolves to your local build:

git clone https://github.com/artokun/comfyui-mcp
cd comfyui-mcp
npm install
npm run build
npm link

After code changes: npm run build, then /mcp to reconnect.

​1. Install ComfyUI

ComfyUI Desktop

From source

​2. Add the MCP server

​3. (Optional) Tokens

​Local development

1. Install ComfyUI

2. Add the MCP server

3. (Optional) Tokens

Local development