MCP server + embedded terminal that lets Claude Code see and edit your ComfyUI workflows
# Add to your Claude Code skills
git clone https://github.com/ConstantineB6/comfy-pilotTalk to your ComfyUI workflows. Comfy Pilot gives Claude Code direct access to see, edit, and run your workflows — with an embedded terminal right inside ComfyUI.
![]()
Building ComfyUI workflows means manually searching for nodes, dragging connections, and tweaking values one at a time. With Comfy Pilot, you just describe what you want:
No copy-pasting node names. No hunting through menus. Just say what you want.
CLI (Recommended):
comfy node install comfy-pilot
ComfyUI Manager:
No comments yet. Be the first to share your thoughts!
Git Clone:
cd ~/Documents/ComfyUI/custom_nodes && git clone https://github.com/ConstantineB6/comfy-pilot.git
Claude Code CLI will be installed automatically if not found.
https://github.com/user-attachments/assets/325b1194-2334-48a1-94c3-86effd1fef02
The MCP server provides these tools to Claude Code:
| Tool | Description |
|------|-------------|
| get_workflow | Get the current workflow from the browser |
| summarize_workflow | 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 | Queue status, system stats, and execution history |
| run | Run workflow (optionally up to a specific node) or interrupt |
| edit_graph | Batch create, delete, move, connect, and configure nodes |
| view_image | View images from Preview Image / Save Image nodes |
| search_custom_nodes | Search ComfyUI Manager registry for custom nodes |
| install_custom_node | Install a custom node from the registry |
| uninstall_custom_node | Uninstall a custom node |
| update_custom_node | Update a custom node to latest version |
| download_model | Download models from Hugging Face, CivitAI, or direct URLs |
Create a KSampler and connect it to my checkpoint loader
Claude will use edit_graph to:
Look at the preview image and describe what you see
Claude will use view_image to fetch and analyze the image output.
Download the FLUX.1 schnell model for me
Claude will use download_model to download from Hugging Face to your ComfyUI models folder. Supports:
┌─────────────────────────────────────────────────────┐
│ Browser (ComfyUI) │
│ ┌─────────────────┐ ┌──────────────────────────┐ │
│ │ xterm.js │ │ Workflow State │ │
│ │ Terminal │ │ (synced to backend) │ │
│ └────────┬────────┘ └────────────┬─────────────┘ │
│ │ WebSocket │ REST API │
└───────────┼────────────────────────┼────────────────┘
│ │
▼ ▼
┌─────────────────────────────────────────────────────┐
│ ComfyUI Server │
│ ┌─────────────────┐ ┌──────────────────────────┐ │
│ │ PTY Process │ │ Plugin Endpoints │ │
│ │ (claude CLI) │ │ /claude-code/* │ │
│ └─────────────────┘ └──────────────────────────┘ │
└─────────────────────────────────────────────────────┘
│ │
│ ▼
│ ┌──────────────────────────┐
└──────────▶│ MCP Server │
│ (stdio transport) │
└──────────────────────────┘
__init__.py - Plugin backend: WebSocket terminal, REST endpointsjs/claude-code.js - Frontend: xterm.js terminal, workflow syncmcp_server.py - MCP server for Claude Code integrationCLAUDE.md - Instructions for Claude when working with ComfyUIInstall Claude Code CLI:
macOS / Linux / WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
Windows (CMD):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
The plugin auto-configures MCP on startup. Check ComfyUI console for errors, or manually add to ~/.claude.json:
{
"mcpServers": {
"comfyui": {
"command": "python3",
"args": ["/path/to/comfy-pilot/mcp_server.py"]
}
}
}
Click the ↻ button to reconnect, or check ComfyUI console for errors.
MIT