Quickstart - ComfyUI MCP

Have a ComfyUI instance running

Install ComfyUI Desktop or run it from source, and start it. ComfyUI MCP auto-detects a local install and its port (8188 / 8000). To target a remote instance, see Configuration.

Add the MCP server to Claude Code

Add it to your Claude Code config (~/.claude/settings.json). npx fetches the latest published package automatically.

~/.claude/settings.json

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "CIVITAI_API_TOKEN": ""
      }
    }
  }
}

Reconnect

Run /mcp in Claude Code (or restart it) to connect to the comfyui server. You should see the ComfyUI MCP tools become available.

Generate something

Ask your assistant in natural language:

Generate an image of a watercolor fox in a misty forest.

Under the hood this calls generate_image, which builds a txt2img workflow, auto-selects a checkpoint, enqueues it, and returns a prompt_id. The finished image arrives via the completion notification — view it with get_image (action:"view").

Next steps

Installation details

Local vs. remote setups and npm link for development.

Configuration

All environment variables and the HTTP transport.

How it works

The model behind the tools — and which ones need a local install.

Browse the tools

The full, schema-generated reference.

​Next steps

Installation details

Configuration

How it works

Browse the tools

Next steps