by artokun
Claude Code plugin + MCP server for ComfyUI — 88 tools, 14 AI skills (Flux, WAN, LTX video, Qwen), live graph editing from your Claude session. Generate images & video, manage models and custom nodes.
# Add to your Claude Code skills
git clone https://github.com/artokun/comfyui-mcpLast scanned: 6/13/2026
{
"issues": [
{
"type": "npm-audit",
"message": "esbuild: esbuild: Missing binary integrity verification in Deno module enables remote code execution via NPM_CONFIG_REGISTRY",
"severity": "high"
},
{
"type": "npm-audit",
"message": "tsx: Vulnerability found",
"severity": "high"
},
{
"file": "README.md",
"line": 712,
"type": "secret-exfiltration",
"message": "Instruction appears to send credentials/secrets to an external endpoint",
"severity": "medium"
}
],
"status": "WARNING",
"scannedAt": "2026-06-13T07:46:22.115Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}comfyui-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by artokun. Claude Code plugin + MCP server for ComfyUI — 88 tools, 14 AI skills (Flux, WAN, LTX video, Qwen), live graph editing from your Claude session. Generate images & video, manage models and custom nodes. It has 152 GitHub stars.
comfyui-mcp returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.
Clone the repository with "git clone https://github.com/artokun/comfyui-mcp" and add it to your Claude Code skills directory (see the Installation section above).
comfyui-mcp is primarily written in TypeScript. It is open-source under artokun on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh comfyui-mcp against similar tools.
No comments yet. Be the first to share your thoughts!
Requires a passing catalog security scan. Resolve the flagged issues and resubmit to enable featuring.
Claude Code plugin + MCP server for ComfyUI — generate images and video, execute and author workflows, manage models and custom nodes, and edit your live ComfyUI graph from your Claude session (sidebar panel, zero API keys).
Works on macOS, Linux, and Windows. Auto-detects your ComfyUI installation and port.
88 MCP tools | 16 AI skills (Flux · WAN · LTX video · Qwen · Z-Image · model registry · Civitai · node authoring) | 11 slash commands | 4 autonomous agents | 4 hooks
The plugin ships expert skills that grow with every release — model-specific generation guides with curated download URLs, workflow recipes, troubleshooting, and custom-node authoring — so Claude knows the right sampler, CFG, resolution, and model files for each architecture without trial and error.
🚧 Coming soon: the ComfyUI MCP Panel on ComfyUI-Manager & the Comfy Registry
Claude in your ComfyUI sidebar — live graph edits, activity cards, multi-tab, zero API keys. v0.3 is in final testing. Read more →
📖 Full documentation: comfyui-mcp.artokun.io/docs
1. Install ComfyUI (if you haven't already): ComfyUI Desktop or from source
2. Add the MCP server to your Claude Code config (~/.claude/settings.json):
{
"mcpServers": {
"comfyui": {
"command": "npx",
"args": ["-y", "comfyui-mcp"],
"env": {
"CIVITAI_API_TOKEN": ""
}
}
}
}
3. Start using it. With ComfyUI running, ask Claude to generate an image:
> Generate an image of a sunset over mountains
Claude will find (or download) a checkpoint, build a workflow, execute it, and return the image.
Note: This runs as a standalone MCP server — no need to clone this repo.
npxwill download and run it automatically.
comfyui-mcp is the community MCP for local and remote ComfyUI (Mac/Linux/Windows installs, RunPod, VPS, LAN, etc.) — that's the primary target.
For Comfy Cloud users, Comfy-Org ships an official Comfy Cloud MCP (currently invite-only beta) which is cloud-exclusive and maintained by the Comfy team. comfyui-mcp also includes a community cloud-mode (set COMFYUI_API_KEY — see Deployment modes) so a single MCP can target all three deployment shapes from one config; pick whichever fits your workflow.
This package also ships as a Claude Code plugin, providing slash commands, skills, agents, and hooks on top of the MCP tools.
# In Claude Code
/plugin marketplace add artokun/comfyui-mcp
/plugin install comfy
| Command | Description |
|---|---|
/comfy:gen <prompt> |
Generate an image from a text description — auto-selects checkpoint, builds workflow, returns image |
/comfy:viz <workflow> |
Visualize a workflow as a Mermaid diagram with nodes grouped by category |
/comfy:node-skill <pack> |
Generate a Claude skill for a custom node pack from Registry ID or GitHub URL |
/comfy:debug [prompt_id] |
Diagnose why a workflow failed — reads history, logs, traces root cause, suggests fixes |
/comfy:batch <prompt, params> |
Parameter sweep generation across cfg, sampler, steps, seed, etc. |
/comfy:convert <file> |
Convert between UI format and API format workflows |
/comfy:install <pack> |
Install a custom node pack — git clone, pip install, optional restart |
/comfy:gallery [filter] |
Browse generated outputs with metadata — filter by date, count, or filename |
/comfy:compare <a vs b> |
Diff two workflows side by side — shows added/removed nodes and changed parameters |
/comfy:recipe <name> <prompt> |
Multi-step recipes: portrait, hires-fix, style-transfer, product-shot |
16 skills total — model-family guides (Flux, WAN, LTX, Qwen, Z-Image), the model-registry (curated download URLs), the civitai pairing skill, node authoring, and the core four below. Full list on the plugin docs page.
| Skill | Description |
|---|---|
| comfyui-core | Workflow format, node types, data flow patterns, pipeline architecture, MCP tool usage guide |
| prompt-engineering | CLIP weight syntax (word:1.3), BREAK tokens, embeddings, model-specific prompting for SD1.5/SDXL/Flux/SD3 |
| troubleshooting | Common error catalog — OOM, dtype mismatches, missing nodes, NaN tensors, black images, CUDA errors, with VRAM estimates per model |
| model-compatibility | Compatibility matrix — loaders, resolutions, CFG, samplers, ControlNets, LoRAs, and VAEs per model family (SD1.5/SDXL/Turbo/Lightning/Flux/SD3/LTXV) |
| Agent | Model | Description |
|---|---|---|
| comfy-explorer | Sonnet | Researches custom node packs — reads docs, queries /object_info, generates comprehensive skill files |
| comfy-debugger | Sonnet | Autonomously diagnoses workflow failures — gathers logs + history, identifies failing node, checks models + custom nodes, proposes and optionally applies fixes |
| comfy-optimizer | Sonnet | Analyzes workflows for performance — detects redundant nodes, VRAM waste, wrong CFG/steps for model family, precision issues, suggests optimizations |
| Event | Trigger | Action |
|---|---|---|
| PreToolUse | enqueue_workflow |
VRAM watchdog — checks GPU memory via /system_stats and warns if < 1GB free before execution |
| PreToolUse | stop_comfyui, restart_comfyui |
Save warning — prompts user to save unsaved workflow changes before stopping ComfyUI |
| PostToolUse | Any comfyui tool | Job completion notify — checks for completed jobs and injects completion summaries into the conversation |
| Script | Description |
|---|---|
monitor-progress.mjs |
Progress monitor — connects to ComfyUI's WebSocket for real-time step progress (e.g., step 5/14 (36%)). Run as a background Bash task after enqueuing workflows. Reports completion with output filenames, errors with node details. Replaces polling get_job_status in a loop. |
46 tools across workflow execution, generation, iteration, composition, models, and more:
| Tool | Description |
|---|---|
generate_image |
Generate from a text prompt — builds a txt2img workflow, fills unspecified params from your defaults, auto-selects a checkpoint |
generate_with_controlnet |
Generate conditioned by a ControlNet image (pose/depth/canny/normal) + prompt |
generate_with_ip_adapter |
Generate guided by a reference image's style/subject via IP-Adapter (needs ComfyUI_IPAdapter_plus) |
| Tool | Description |
|---|---|
view_image |
Return a generated asset's bytes as an inline image so the agent can see the result |
regenerate |
Re-run the workflow that produced an asset_id, with optional parameter overrides |
list_assets |
Browse recently generated assets (newest-first) by asset_id |
get_asset_metadata |
Full provenance for an asset, including the originating workflow |
| Tool | Description |
|---|---|
get_defaults |
Show merged generation defaults with per-source attribution |
set_defaults |
Update runtime defaults; persist: true writes the config file |
| Tool | Description |
|---|---|
enqueue_workflow |
Submit a workflow (API format JSON) — returns prompt_id immediately, non-blocking |
get_job_status |
Check execution status of a job by prompt ID |
get_queue |
View the current execution queue (running + pending) |
cancel_job |
Interrupt the currently running job |
get_system_stats |
Get system info — GPU, VRAM, Python version, OS |
| Tool | Description |
|---|---|
visualize_workflow |
Convert a workflow to a Mermaid flowchart with nodes grouped by category |
mermaid_to_workflow |
Convert a Mermaid diagram back to executable workflow JSON |
| Tool | Description |
|---|---|
create_workflow |
Generate a workflow from templates: txt2img, img2img, upscale, inpaint |
modify_workflow |
Apply operations: set_input, add_node, remove_node, connect, insert_between |
get_node_info |
Query available node types from ComfyUI's /object_info endpoint |
| Tool | Description |
|---|---|
validate_workflow |
Dry-run validation — checks missing nodes, broken connections, invalid output indices, missing model files |
| Tool | Description |
|---|---|
| `list_work |