Comfy Cloud MCP Server
Official MCP server for Comfy Cloud - generate images, video, audio, and 3D, run ComfyUI workflows, and search models directly from Claude and other AI agents
Documentation
Comfy Cloud MCP
This is a **Comfy Cloud** feature and is only available in the cloud version. To learn more about Comfy Cloud, see [Comfy Cloud](/get_started/cloud). **Public beta.** Comfy Cloud MCP is in public beta. APIs, tools, and behavior may change while we iterate. See [Feedback](#feedback) to report issues or share suggestions.Use Comfy Cloud from Claude Code and Claude Desktop through the Comfy Cloud MCP server — generate images, video, audio, and 3D, search models and nodes, and run workflows.
Overview
The Comfy Cloud MCP server connects AI agents to Comfy Cloud over the Model Context Protocol. Once connected, you can generate images, video, audio, and 3D, search models, nodes, and templates, and run ComfyUI workflows from a chat with your agent.
The server runs remotely at cloud.comfy.org/mcp. Workflows execute on Comfy Cloud GPUs, so you do not need a local GPU. Your agent talks to the server over HTTPS; the server translates tool calls into authenticated requests to Comfy Cloud on your behalf.
Support is currently scoped to Claude Code and Claude Desktop, which sign in with OAuth (a one-time browser sign-in). Support for more clients is coming.
What your agent can do
You do not call MCP tools yourself. Your agent picks the right tool based on what you ask for. Slash commands and prompts (below) are shortcuts that steer the agent toward common tasks, but plain language works too ("generate an image of a cat astronaut", "upscale this photo", "find a Wan 2.2 video template").
Typical flow:
- Discover what is available (
search_templates,search_models,search_nodes, orcqlfor graph-style questions). - Run a generation or workflow (
submit_workflow, withupload_filewhen an input image is needed). - Retrieve outputs (
get_outputreturns a download command your agent runs in your shell).
The server prefers matching pre-built templates before building a workflow from scratch, which tends to produce better results faster.
MCP tools
These are the tools your agent has access to once connected. Names match what appears in MCP client logs and debugging.
Discovery
| Tool | Description |
|---|---|
search_templates | Search pre-built workflow templates from comfy.org by text, tag, media type, or model |
search_models | Search the model catalog by text, type, base model, or source |
search_nodes | Search available nodes by text, category, or input/output types. Also surfaces subgraph blueprints (pre-wired node groups like Text to Image or Remove Background) |
cql | Run a CQL graph query for structural questions (for example, which nodes produce images, or paths between node types). Use search_nodes when you need full input specs for a specific node |
Execution
| Tool | Description |
|---|---|
submit_workflow | Submit a ComfyUI API-format workflow for execution on Comfy Cloud |
upload_file | Upload an input image or file for use in workflows (for example, with LoadImage) |
get_job_status | Poll execution status of a submitted workflow |
get_output | Retrieve output images, videos, or audio from a completed workflow |
use_previous_output | Chain workflows by reusing output from one run as input to another |
cancel_job | Cancel a pending or running job |
get_queue | Check how many jobs are running and pending |
Saved workflows
| Tool | Description |
|---|---|
list_saved_workflows | Browse your saved workflows from Comfy Cloud |
get_saved_workflow | Inspect a saved workflow's nodes, inputs, and configuration |
save_workflow | Save a workflow to your Comfy Cloud account |
Sharing workflows
| Tool | Description |
|---|---|
share_workflow | Publish a saved workflow and return a ?share=<id> URL anyone can open |
import_shared_workflow | Resolve a share URL or bare share ID into workflow JSON, optionally saving it to your account |
Hub URL share IDs: the trailing hyphen-delimited hex token in a comfy.org/workflows/<slug>-<hex> hub URL is the share ID. For example, comfy.org/workflows/topaz-starlight-upscale-1c77e82713b7 has share ID 1c77e82713b7. Pass that token to import_shared_workflow as share_id. The share_url parameter only accepts ?share=<id> query URLs like https://cloud.comfy.org/?share=..., not hub page URLs.
Install
Pick your client:
Install the plugin. Connection and commands in one step. Add a custom connector in the app, then sign in.<span style={{ marginRight: "0.6rem" }}> Claude Code
Install the comfy-cloud plugin. It adds the MCP connection and the 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.
Register the Comfy Skills marketplace (one-time):```
/plugin marketplace add Comfy-Org/comfy-skills
```
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 |
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.
<span style={{ marginRight: "0.6rem" }}> Claude Desktop
Claude Desktop adds Comfy Cloud as a custom connector through its UI, then runs the OAuth sign-in.
In Claude Desktop, open **Customize**, then choose **Connectors**.<img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-connectors.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=64d90eeac78724a81cee358e4a509a9b" alt="Claude Desktop Connectors" width="566" height="232" data-path="images/cloud/mcp/desktop-connectors.png" />
<img src="https://mintcdn.com/dripart/VcJUoOhemC23a4kR/images/cloud/mcp/desktop-add-custom-connector.png?fit=max&auto=format&n=VcJUoOhemC23a4kR&q=85&s=ace4d0901bcbfcccf6e688c9f88ac369" alt="Add custom connector" width="794" height="292" data-path="images/cloud/mcp/desktop-add-custom-connector.png" />
```
https://cloud.comfy.org/mcp
```
<img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-connector-url.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=89ff669fd6d2ec94917a1ccfecdd2608" alt="Connector details" width="1138" height="898" data-path="images/cloud/mcp/desktop-connector-url.png" />
<img src="https://mintcdn.com/dripart/hggE7jk4IUe9Dgn5/images/cloud/mcp/desktop-signin.png?fit=max&auto=format&n=hggE7jk4IUe9Dgn5&q=85&s=2a9dbc39cdac3aa4626b3dc911e74568" alt="Sign in through Claude Desktop" width="430" height="561" data-path="images/cloud/mcp/desktop-signin.png" />
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.
Headless / CI (API key)
Claude Code and Claude Desktop use OAuth, so you do not need an API key. For headless or CI setups where no browser is available, authenticate with an API key instead:
Go to [platform.comfy.org/profile/api-keys](https://platform.comfy.org/profile/api-keys), click **New API Key**, and copy it (it starts with `comfyui-`). ```bash theme={null} claude mcp add --transport http comfy-cloud https://cloud.comfy.org/mcp -H "X-API-Key: comfyui-…" ```Outputs and downloads
The MCP server runs in the cloud and never writes files to your machine. When a generation completes, your agent calls get_output, which returns:
- A temporary signed download URL (valid for a short window).
- A ready-to-run shell command (
curlon macOS and Linux,curl.exeon Windows).
Your agent should run that command in your shell. The command includes the destination path and filename.
Run the returned command **verbatim**. Do not re-encode or edit the signed URL. The signature lives in the query string and breaks if the URL is modified.If your MCP client cannot run shell commands (some GUI-only setups), copy the command and run it yourself in a terminal.
Related resources
| Resource | What it's for |
|---|---|
| Comfy Skills | Claude Code plugin marketplace and community skill library. The comfy-cloud plugin used above is distributed here; browse or contribute additional skills for Comfy workflows. |
| Comfy CLI | Command-line tool for local ComfyUI install/launch and for calling hosted partner nodes from scripts or CI (comfy generate, in beta). Complements MCP when you need terminal or automation workflows. |
| Share a workflow on Comfy Cloud | Share workflows from the Comfy Cloud UI (the MCP share_workflow tool does this from an agent session). |
Feedback
Comfy Cloud MCP is in public beta. Please try it out and tell us what works and what doesn't:
- 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
Comfy Cloud MCP is an early release. These limitations are known and being worked on:
Workflows
- Saved workflows cannot be run by ID. Your agent can list and inspect saved workflows, but must reconstruct or convert them to API format before execution.
- Generated assets may not embed workflow metadata. Images created via MCP might not reopen the workflow when opened in ComfyUI.
- Workflow building depends on agent accuracy. Complex multi-node workflows may need a retry or refinement.
File handling
- 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.
Authentication
- OAuth or API key. Claude Code and Claude Desktop use a one-time browser OAuth flow. Headless clients can pass a Comfy Cloud API key via the
X-API-Keyheader instead. A device-code OAuth flow for clients that cannot open a browser is planned.
FAQ
Claude Code and Claude Desktop today, both signing in with OAuth. Support for more clients is coming. Not for Claude Code or Claude Desktop. They use OAuth. An API key is only needed for headless or CI setups with no browser. No. Slash commands ship in the Claude Code plugin. Claude Desktop connects to the same MCP server (the tools work if you ask in plain language or use the prompt picker), but it does not support Claude Code plugins or slash commands. There is no `/comfy` or `/cloud` command. Commands appear under one of two prefixes depending on how you connected:* **Plugin (recommended):** `/comfy-cloud:generate-image`, `/comfy-cloud:generate-video`, … — type `/comfy-cloud:` to see them all.
* **Direct connection (no plugin):** `/mcp__comfy-cloud__generate-image`, … — type `/mcp__` to see them.
Either way you can also just ask in plain language ("generate an image of …"). The MCP tools are model-invoked and do not require a slash command.