comfyui-mcp — Claude Code MCP server: control ComfyUI
An MCP server that hands your agent the keys to ComfyUI: image, video and audio generation, graph edits, model and VRAM management.
claude mcp add comfyui-mcp -- npx -y comfyui-mcpWhat comfyui-mcp does
Setup is one command, and the server runs through npx — no repo to clone. Once connected, the agent gets a set of ComfyUI tools: it builds and edits the graph node by node, runs workflows, frees VRAM, pulls checkpoints and handles custom nodes. It finds your ComfyUI install and port on its own.
Local-first, but the same config reaches remote instances too — RunPod, a VPS, a box on your LAN. Pick whatever model you already pay for: a Claude or ChatGPT subscription, Gemini through your Google login, or a local model via Ollama with no network at all. Civitai access needs a CIVITAI_API_TOKEN; without it that part of model handling stops working.
Maintenance is limited right now. Releases cover verified critical fixes only, and there is no broad feature roadmap. No GPU, or no appetite for setup? Comfy ships its own agent tooling for Comfy Cloud, hosted on their hardware — that path skips the install entirely.
What it helps with
- generate an image from a text prompt without leaving the chat
- run a ComfyUI workflow end to end from the agent
- free VRAM before the next render
- download a checkpoint and wire up custom nodes
- edit the live graph node by node in plain language
Example prompts for the agent
- Generate an image of a sunset over mountains
- Build a Flux workflow and run it
- Free VRAM and show me what is loaded
How to install comfyui-mcp
Platform CLI
claude mcp add comfyui-mcp -- npx -y comfyui-mcpPlatform CLI
codex mcp add comfyui-mcp -- npx -y comfyui-mcpConfig file
{
"mcpServers": {
"comfyui-mcp": {
"command": "npx",
"args": [
"-y",
"comfyui-mcp"
]
}
}
}Config file
{
"servers": {
"comfyui-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"comfyui-mcp"
]
}
}
}Platform CLI
gemini mcp add comfyui-mcp npx -y comfyui-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about comfyui-mcp
How do I install comfyui-mcp in Claude Code?
Run claude mcp add comfyui-mcp -- npx -y comfyui-mcp. ComfyUI itself has to be installed and running.
What does comfyui-mcp do?
It gives an agent tools to operate ComfyUI: generate images, video and audio, author and run workflows, manage models and custom nodes, and edit the live graph.
Do I need an API key?
Not for a local Ollama model — it runs offline with no account. Civitai access requires a CIVITAI_API_TOKEN.
