MCP Directory

How to add Comfy Pilot to Claude Desktop

MCP server + embedded terminal that lets Claude Code see, edit, and run your ComfyUI workflows. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 213★ · stdio · no auth

Claude Desktop config for Comfy Pilot

comfy node install comfy-pilot
{
  "mcpServers": {
    "comfy-pilot": {
      "command": "python3",
      "args": [
        "/path/to/comfy-pilot/mcp_server.py"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Comfy Pilot config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Comfy Pilot's tools appear under the 🔌 tools menu.

Before you start

  • ComfyUI
  • Python 3.8+
  • Claude Code CLI (installed automatically if not found)

What Comfy Pilot can do in Claude Desktop

get_workflow

Get the current workflow from the browser.

summarize_workflow

Produce a human-readable workflow summary.

get_node_types

Search available node types with filtering.

get_node_info

Get detailed info about a specific node type.

get_status

Get queue status, system stats, and execution history.

run

Run the workflow (optionally up to a specific node) or interrupt it.

edit_graph

Batch create, delete, move, connect, and configure nodes.

view_image

View images from Preview Image / Save Image nodes.

Security

The plugin runs the Claude Code CLI as a PTY process inside ComfyUI and exposes tools that can edit workflows, install custom nodes, and download models to your machine. The MCP server runs locally over stdio with no authentication; only use it with a ComfyUI instance you trust. The download_model tool can fetch gated Hugging Face models using a token if provided.

Comfy Pilot + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Comfy Pilot config there under the "mcpServers" key and restart the client.

Is Comfy Pilot safe to use with Claude Desktop?

The plugin runs the Claude Code CLI as a PTY process inside ComfyUI and exposes tools that can edit workflows, install custom nodes, and download models to your machine. The MCP server runs locally over stdio with no authentication; only use it with a ComfyUI instance you trust. The download_model tool can fetch gated Hugging Face models using a token if provided.

How do I install it?

Use the ComfyUI CLI with `comfy node install comfy-pilot`, install via ComfyUI Manager by searching for "Comfy Pilot", or git clone the repo into ComfyUI's custom_nodes folder. Restart ComfyUI afterward.

Do I need to configure the MCP server manually?

No. The plugin auto-configures MCP for Claude Code on startup. If it isn't connecting, you can manually add the comfyui server to ~/.claude.json with command python3 and args pointing to mcp_server.py.

The terminal says 'Command claude not found'. What do I do?

Install the Claude Code CLI. On macOS/Linux/WSL run `curl -fsSL https://claude.ai/install.sh | bash`; on Windows use the PowerShell or CMD installer from claude.ai.

View repo Full Comfy Pilot page