Use when the user wants to create a ComfyUI custom node, convert Python code to a node, make a node from a script, or needs help with ComfyUI node development, INPUT_TYPES, RETURN_TYPES, or node class structure.
Add this skill
npx mdskills install ConstantineB6/comfy-nodesPractical ComfyUI node development guide with clear templates, type mappings, and batch handling examples
Talk 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:
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
Best experience: Claude Code
/plugin marketplace add ConstantineB6/comfy-nodesThen /plugin menu → select skill → restart. Use /skill-name:init for first-time setup.
Other platforms
Install via CLI
npx mdskills install ConstantineB6/comfy-nodesComfy Nodes is a free, open-source AI agent skill. Use when the user wants to create a ComfyUI custom node, convert Python code to a node, make a node from a script, or needs help with ComfyUI node development, INPUT_TYPES, RETURN_TYPES, or node class structure.
Install Comfy Nodes with a single command:
npx mdskills install ConstantineB6/comfy-nodesThis downloads the skill files into your project and your AI agent picks them up automatically.
Comfy Nodes works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Codex, Gemini Cli, Amp, Roo Code, Goose, Opencode, Trae, Qodo, Command Code. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.