Comfy Cloud MCP

​

Overview

​

Install Comfy Cloud MCP

https://cloud.comfy.org/mcp

• Claude Code
• Claude Desktop
• Cursor
• Codex
• Other clients

Install the comfy-cloud plugin. It adds the MCP connection and slash commands in one step. The plugin is published through the Comfy Skills repository, which hosts Claude Code plugins and community agent skills for Comfy.

1

Add the marketplace

Register the Comfy Skills marketplace (one-time):

/plugin marketplace add Comfy-Org/comfy-skills

2

Install the plugin

/plugin install comfy-cloud@comfy-skills

3

Sign in

Run /mcp, select comfy-cloud → Authenticate. Your browser opens to sign in, and tokens refresh automatically.

The plugin adds these slash commands:

Command	What it does
/comfy-cloud:generate-image	Generate, edit, or modify an image
/comfy-cloud:generate-video	Generate, edit, or extend a video
/comfy-cloud:generate-audio	Generate audio, music, or sound effects
/comfy-cloud:generate-3d	Generate a 3D model from text or an image
/comfy-cloud:remove-background	Remove the background from an image
/comfy-cloud:upscale-image	Upscale an image to higher resolution
/comfy-cloud:search-templates	Find pre-built workflow templates on comfy.org
/comfy-cloud:search-models	Search for available models
/comfy-cloud:search-nodes	Search for nodes and get wiring suggestions
/comfy-cloud:help	See what you can do with ComfyUI Cloud

Prefer just the connection, without the plugin?

Add the server directly:

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp

Then run /mcp, select comfy-cloud → Authenticate. Add -s user to make it available in all your projects.This path still exposes the same workflows as MCP prompts: /mcp__comfy-cloud__generate-image, /mcp__comfy-cloud__search-models, and so on (the /mcp__<name>__ prefix uses the name you passed to claude mcp add). The plugin above is recommended because it wraps these as the friendlier /comfy-cloud:* commands.

Claude Desktop adds Comfy Cloud as a custom connector through its UI, then runs the OAuth sign-in.

1

Open Customize

In the sidebar, click Customize (labeled 1).

2

Open Connectors

Click Connectors (labeled 2).

3

Add a custom connector

1. Click the + button (labeled 3) in the Connectors header.
2. Choose Add custom connector (labeled 4).

4

Enter server details

1. Enter a name such as Comfy Cloud MCP in the Name field (labeled 5).
2. Set the Remote MCP server URL to https://cloud.comfy.org/mcp (labeled 6).
3. Click Add (labeled 7).

5

Sign in

1. When the browser opens, choose your workspace (for example Personal Workspace).
2. Click Continue to authorize the connector. You are connected.

Claude Desktop does not support Claude Code slash commands. Instead, open the prompt picker for the same workflows:

Prompt	Description
generate-image	Generate an image from a text description
generate-video	Generate a video from text or an image
generate-audio	Generate audio, music, or sound effects
generate-3d	Generate a 3D model from text or an image
upscale-image	Upscale an image to higher resolution
remove-background	Remove the background from an image
search-templates	Find pre-built workflow templates
search-models	Search for models (checkpoints, LoRAs, VAEs)
search-nodes	Search nodes and get wiring suggestions
help	See what you can do with ComfyUI Cloud

You can also skip prompts and ask in plain language. The MCP tools work the same way.

Cursor connects to remote MCP servers over HTTP. Cursor does not support MCP OAuth today. Add Comfy Cloud with a Comfy Cloud API key in your MCP config.

1

Open Cursor Settings

Click the Settings gear in the top-right corner (labeled 1).

2

Open Tools & MCP

1. In the sidebar, click Tools & MCPs (labeled 2).
2. Click + New MCP Server (labeled 3) → Add a Custom MCP Server.

3

Add your API key

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project). Set the server URL and pass your Comfy Cloud API key in the X-API-Key header. Create a key at platform.comfy.org/profile/api-keys (starts with comfyui-):

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "${env:COMFY_API_KEY}"
      }
    }
  }
}

Set COMFY_API_KEY in your shell or system environment. Prefer ${env:COMFY_API_KEY} over hardcoding the key in a file you might commit to git.

4

Start generating

Ask in plain language (“generate an image of a cat astronaut”, “find a Wan 2.2 video template”). Cursor invokes the MCP tools on your behalf.

Codex connects to Comfy Cloud over Streamable HTTP. Add the server in Settings, then sign in with OAuth.

1

Open the settings panel

1. Click Settings (labeled 1) under Logged in with API key.
2. Click Settings (labeled 2) to open the full settings panel.

2

Open MCP server settings

1. Click MCP servers (labeled 3) in the settings list.
2. Click + Add server (labeled 4) to add a new MCP server.

3

Connect to Comfy Cloud

1. Choose Streamable HTTP as the connection type.
2. Enter a name such as Comfy Cloud MCP in the Name field (labeled 5).
3. Enter the URL https://cloud.comfy.org/mcp in the URL field (labeled 6).
4. Click Save (labeled 7).

4

Authenticate

1. Click Authenticate (labeled 8) on the saved server entry.
2. In the browser popup, choose your workspace and click Continue to finish signing in. You are connected.

Ask in plain language (“generate an image of a cat astronaut”, “find a Wan 2.2 video template”). Codex invokes the MCP tools on your behalf.

Prefer the CLI instead?

Register and sign in from the terminal:

codex mcp add comfy-cloud --url https://cloud.comfy.org/mcp
codex mcp login comfy-cloud

This writes an entry to ~/.codex/config.toml (or .codex/config.toml in a trusted project).

API key instead of OAuth (headless or CI)

When no browser is available, add the server with a header pulled from an environment variable. Create a key at platform.comfy.org/profile/api-keys (starts with comfyui-), then add to ~/.codex/config.toml:

[mcp_servers.comfy-cloud]
url = "https://cloud.comfy.org/mcp"
env_http_headers = { "X-API-Key" = "COMFY_API_KEY" }

Set COMFY_API_KEY in your shell or system environment. Do not commit the key to version control.

Any MCP client that supports remote HTTP transport can connect to Comfy Cloud. The server URL is always https://cloud.comfy.org/mcp.

1

Add the server URL

Add a remote MCP entry pointing at https://cloud.comfy.org/mcp. Most clients use a JSON config with a url field:

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp"
    }
  }
}

Windsurf uses serverUrl instead of url. Amp uses the same mcpServers shape in Settings → MCP Servers or ~/.config/amp/settings.json.

2

Authenticate

If your client supports MCP OAuth, sign in through the browser when prompted. Otherwise, add an API key header (see below).

3

Restart and verify

Restart your client. You should see Comfy Cloud tools (search_templates, submit_workflow, get_output, and others) registered under the comfy-cloud server.

Headless / CI (API key): when OAuth is not available, create a key at platform.comfy.org/profile/api-keys and pass it as the X-API-Key header:

{
  "mcpServers": {
    "comfy-cloud": {
      "url": "https://cloud.comfy.org/mcp",
      "headers": {
        "X-API-Key": "comfyui-…"
      }
    }
  }
}

For Claude Code from the terminal:

claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…"

Prefer ${env:COMFY_API_KEY} or your client’s secret interpolation instead of hard-coding keys in config files you commit to git.

​

What your agent can do

1. Discover what is available (search_templates, search_models, search_nodes, or cql for graph-style questions).
2. Run a generation: run_template for a matching pre-built template, submit_workflow for a custom workflow (with upload_file when an input image is needed), or partner_generate for partner models like Flux, Grok, Gemini, OpenAI, Ideogram, and Seedance.
3. Wait and retrieve outputs (wait_for_job, then get_output returns a download command your agent runs in your shell).

​

MCP tools

​

Discovery

​

Generation

​

Jobs and batches

​

Saved workflows

​

Sharing workflows

​

Apps and links

​

Account and session

​

Credits and spending

​

Outputs and downloads

1. A temporary signed download URL (valid for a short window).
2. A ready-to-run shell command (curl on macOS and Linux, curl.exe on Windows).

​

Related resources

​

Feedback

• Feedback survey: report bugs, request features, or share general impressions.
• Discord: #comfy-mcp-and-cli on the Comfy Discord for questions and discussion.

​

Known limitations

• Editor-to-executable conversion has rough edges. Saved workflows run by filename via run_saved_workflow (the server converts them automatically), but some node configurations still convert imperfectly.
• Assets generated via submit_workflow may not embed workflow metadata. They might not reopen the originating workflow when opened in ComfyUI.
• Workflow building depends on agent accuracy. Complex multi-node workflows may need a retry or refinement.

• Outputs require a shell download step. See Outputs and downloads.
• Upload size limits may apply depending on your MCP client. Some clients impose their own limits on file uploads.

• OAuth or API key. Claude Code and Claude Desktop use a one-time browser OAuth flow. Cursor requires a Comfy Cloud API key in your MCP config (no OAuth). Other headless clients can pass a Comfy Cloud API key via the X-API-Key header instead. A device-code OAuth flow for clients that cannot open a browser is planned.

​

FAQ