Skip to main content
Glama

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 /prompt

  • inspect 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:

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_PREFIX can be set to /api if 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_org in comfyui_submit_prompt.

3) Run (stdio transport)

cd /Users/apple/projects/comfyui-mcp
source .venv/bin/activate
comfyui-mcp

4) 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_stats

  • comfyui_get_features

  • comfyui_list_models

  • comfyui_get_object_info

  • comfyui_get_queue

  • comfyui_manage_queue

  • comfyui_get_history

  • comfyui_manage_history

  • comfyui_submit_prompt

  • comfyui_interrupt

  • comfyui_upload_image

Available Tools

11 tools
comfyui_get_featuresA
Read-onlyIdempotent

Get server feature flags from ComfyUI /features.

Inputs: no named parameters. Returns: result

comfyui_get_historyC
Read-onlyIdempotent

Fetch history from /history or /history/{prompt_id}.

Inputs: params (required). Returns: result

comfyui_get_object_infoA
Read-onlyIdempotent

Fetch node metadata from /object_info or /object_info/{node_class}.

Inputs: params (required). Returns: result

comfyui_get_queueA
Read-onlyIdempotent

Get pending and running queue state from /queue.

Inputs: no named parameters. Returns: result

comfyui_get_system_statsA
Read-onlyIdempotent

Get Python, device, and VRAM information from ComfyUI /system_stats.

Inputs: no named parameters. Returns: result

comfyui_interruptB
Destructive

Interrupt current execution globally or by prompt_id via POST /interrupt.

Inputs: params (required). Returns: result

comfyui_list_modelsA
Read-onlyIdempotent

List model folders or files from /models and /models/{folder}.

Inputs: params (required). Returns: result

comfyui_manage_historyA
Destructive

Clear history or delete prompt ids via POST /history.

Inputs: params (required). Returns: result

comfyui_manage_queueA
Destructive

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

    A3.7/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct ComfyUI API endpoint or action, with clear descriptions preventing any confusion. No overlapping purposes exist.

    Naming Consistency5/5

    All tools follow a consistent 'comfyui_verb_noun' pattern (e.g., comfyui_get_history, comfyui_submit_prompt), making naming predictable and easy to navigate.

    Tool Count5/5

    With 11 tools, the set covers the essential operations for interacting with ComfyUI without being excessive or sparse. Each tool serves a clear purpose.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers