ComfyUI MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ComfyUI MCP list available models"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ComfyUI MCP
Minimal MCP server that wraps ComfyUI HTTP routes so an LLM client can:
inspect server status, models, features, node metadata
submit workflows via
/promptinspect or manage queue/history
interrupt runs
upload input images
Python requirement: 3.10+ (the official mcp SDK requires it).
This server targets ComfyUI local server routes documented in:
https://docs.comfy.org/development/comfyui-server/comms_routes
https://docs.comfy.org/development/comfyui-server/api-key-integration
1) Install
cd /Users/apple/projects/comfyui-mcp
python3.10 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .Related MCP server: ComfyMCP Local
2) Configure
export COMFYUI_BASE_URL="http://127.0.0.1:8188"
export COMFYUI_ROUTE_PREFIX=""
export COMFYUI_TIMEOUT_SECONDS="60"
# optional: for reverse proxies or cloud-style gateways
export COMFYUI_BEARER_TOKEN=""Notes:
COMFYUI_ROUTE_PREFIXcan be set to/apiif your endpoint is exposed only under/api/*.ComfyUI native server supports both prefixed and non-prefixed routes.
For paid API nodes in workflow payloads, pass
api_key_comfy_orgincomfyui_submit_prompt.
3) Run (stdio transport)
cd /Users/apple/projects/comfyui-mcp
source .venv/bin/activate
comfyui-mcp4) Example MCP client config
{
"mcpServers": {
"comfyui": {
"command": "/Users/apple/projects/comfyui-mcp/.venv/bin/comfyui-mcp",
"env": {
"COMFYUI_BASE_URL": "http://127.0.0.1:8188",
"COMFYUI_ROUTE_PREFIX": ""
}
}
}
}Exposed tools
comfyui_get_system_statscomfyui_get_featurescomfyui_list_modelscomfyui_get_object_infocomfyui_get_queuecomfyui_manage_queuecomfyui_get_historycomfyui_manage_historycomfyui_submit_promptcomfyui_interruptcomfyui_upload_image
Available Tools
11 toolscomfyui_get_featuresARead-onlyIdempotent
Get server feature flags from ComfyUI /features.
Inputs: no named parameters. Returns: result
comfyui_get_historyCRead-onlyIdempotent
Fetch history from /history or /history/{prompt_id}.
Inputs: params (required). Returns: result
comfyui_get_object_infoARead-onlyIdempotent
Fetch node metadata from /object_info or /object_info/{node_class}.
Inputs: params (required). Returns: result
comfyui_get_queueARead-onlyIdempotent
Get pending and running queue state from /queue.
Inputs: no named parameters. Returns: result
comfyui_get_system_statsARead-onlyIdempotent
Get Python, device, and VRAM information from ComfyUI /system_stats.
Inputs: no named parameters. Returns: result
comfyui_interruptBDestructive
Interrupt current execution globally or by prompt_id via POST /interrupt.
Inputs: params (required). Returns: result
comfyui_list_modelsARead-onlyIdempotent
List model folders or files from /models and /models/{folder}.
Inputs: params (required). Returns: result
comfyui_manage_historyADestructive
Clear history or delete prompt ids via POST /history.
Inputs: params (required). Returns: result
comfyui_manage_queueADestructive
Clear queue or delete pending prompt ids via POST /queue.
Inputs: params (required). Returns: result
comfyui_submit_promptC
Submit a workflow payload to ComfyUI POST /prompt.
Inputs: params (required). Returns: result
comfyui_upload_imageC
Upload an image file using POST /upload/image multipart form.
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct ComfyUI API endpoint or action, with clear descriptions preventing any confusion. No overlapping purposes exist.
All tools follow a consistent 'comfyui_verb_noun' pattern (e.g., comfyui_get_history, comfyui_submit_prompt), making naming predictable and easy to navigate.
With 11 tools, the set covers the essential operations for interacting with ComfyUI without being excessive or sparse. Each tool serves a clear purpose.
The tool set covers core CRUD and lifecycle operations (get, manage, submit, upload, interrupt). Minor omissions like image viewing or memory management exist, but the main workflows are complete.
Maintenance
Related MCP Connectors
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.
Remote MCP for RunComfy: ComfyUI deployments, hosted models, LoRA training. 31 tools.
Official hosted MCP server for Wiro AI. Run 1,000+ image, video, audio and LLM models, build and run workflows that chain them, and deploy and talk to AI agents from any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server that connects local ComfyUI to AI agents, enabling natural language control of ComfyUI for creating workflows, generating images, and managing the queue.1-
- AlicenseNot gradedqualityDmaintenanceLocal-first MCP server for controlling a loopback ComfyUI instance from same-machine or authenticated LAN clients.MIT
- FlicenseNot gradedqualityDmaintenanceMCP server exposing a local (or LAN) ComfyUI instance's HTTP API as tools, so an LLM client can queue generations, inspect the queue/history, upload reference images, browse installed models/nodes, and pull back generated images.-
- AlicenseBqualityBmaintenanceMCP server that dynamically exposes each enabled ComfyUI workflow as a tool with JSON Schema, supports job submission with wait and idempotency, file uploads, and resource metadata, with both stdio and authenticated Streamable HTTP transports.36MIT