
Comfy MCP, Comfy Org's official ComfyUI MCP server
Lets your AI assistant make images, video and audio with ComfyUI, on Comfy Cloud GPUs or the ComfyUI on your own computer.
This is Comfy Org's own way to drive ComfyUI from an AI assistant. The cloud connection runs your requests on Comfy Cloud GPUs after you sign in with your Comfy account. The open-source local connection drives the ComfyUI on your own machine; the tool list below is the local one, and the cloud has its own set. Searching templates and models is free, but cloud generations need an active Comfy Cloud subscription, and partner models such as Flux or Kling spend credits either way.
Good for
- People who want images or video from a chat without installing ComfyUI or owning a GPU
- ComfyUI users who want Claude Code or Cursor to run their own workflows, models and custom nodes
- Developers building image or video pipelines that an agent can run, tweak and re-run
- Mac users who want open-weight models without waiting on the Apple GPU
Works in
5 supported · 2 with issues · 7 should work
Tap an app to see how to set it up and any known problems.
Comfy's docs cover both: the comfy-cloud plugin or URL for the cloud, and one command for the local server. docs.comfy.org
Comfy's docs cover adding the cloud as a custom connector, or the local server in the config file. docs.comfy.org
Comfy's docs cover it. The cloud needs a Comfy API key because Cursor cannot do the browser sign-in. docs.comfy.org
Comfy's docs say to add the cloud address under serverUrl instead of url. docs.comfy.org
Comfy points ChatGPT users to the cloud connection, since ChatGPT only accepts remote connectors. docs.comfy.org
Comfy's docs cover the cloud connection with a browser sign-in. Running several Codex sessions can sign you out.
Known problems
- Open
Keeps asking you to sign in again when several Codex sessions run
Workaround: Turn on Codex's mcp_oauth_refresh_coordination flag, keep the server in one project, or use an API key.
Since Sep 2026 · GitHub
Comfy does not document OpenCode. One open report says running a workflow can return an error even though the image was made.
Known problems
- Open
Run workflow can report an error even though the image was made
Since Oct 2026 · GitHub
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports hosted MCP servers.
Install Comfy MCP
Claude Code
- 1
Copy this prompt.
Add the Comfy MCP server to Claude Code. Run this command: /plugin marketplace add Comfy-Org/comfy-skills /plugin install comfy-cloud@comfy-skills Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires A Comfy account (cloud.comfy.org), Active Comfy Cloud subscription to run generations.
The plugin adds the cloud connection plus /comfy-cloud: slash commands for images, video, audio and 3D. After the URL-only command, run /mcp and choose Authenticate. Add -s user to use it in every project. Install the local server first with pip install comfy-mcp "comfy-cli>=1.14.0", then run comfy launch and leave ComfyUI running. Drop COMFY_BIN if comfy is already on your PATH. Cloud and local sign-ins are separate.
From the vendor's docs. Source.
Tools
Makes an image from a text prompt using a built-in free template
Turns a text prompt into an image in one step by running ComfyUI's built-in text-to-image template on your ComfyUI. It does not spend credits.
Try: “Make an image of a lighthouse at dawn in oil-paint style”
Runs code ·
generate_imageRuns a ComfyUI workflow file and returns the result
Runs a workflow file you have (exported from ComfyUI) on your ComfyUI, waiting for it or running it in the background. Workflows with paid partner nodes only run after you confirm the spend.
Try: “Run the workflow at ~/workflows/txt2img.json and show me the image”
Runs code ·
run_workflowRuns a ready-made gallery template with your settings
Fetches a template from the Comfy gallery, fills in values such as the prompt, and runs it in one step. Templates that use paid partner models only run after you confirm.
Try: “Run the Wan 2.2 text-to-video template with the prompt 'a fox running through snow'”
Runs code ·
run_templateGenerates with a paid hosted model like Flux or Kling, after you approve
Runs a hosted partner model such as Flux, Ideogram or Kling on the partner's servers and saves the result. Every call spends Comfy credits and asks you first.
Try: “Generate a product photo of a red sneaker with Flux Pro”
Write ·
partner_generateCopies a finished job's images or videos into a folder you choose
Copies the files a finished job produced into a folder you name, and can show the images straight in the chat.
Try: “Save the outputs of that last job to ./outputs”
Write ·
fetch_outputsShows a video as a contact sheet or audio as a waveform image
Turns a video into a grid of frames, or audio into a waveform picture, so the assistant can look at the result.
Try: “Show me a contact sheet of the video you just made”
Files ·
preview_mediaFinds ready-made workflow templates by keyword, type or model
Searches the Comfy template gallery by words, media type, model or provider, and marks which templates use paid partner models.
Try: “Find a free image-to-video template”
Network ·
search_templatesShows a template's details and whether your install can run it
Shows one template's details and checks it against your ComfyUI to tell you if any nodes or models are missing.
Try: “Can my install run the Flux Kontext template?”
Network ·
get_templateSaves a template as a workflow file ready to run
Writes a template's runnable workflow file to the path you give, and reports whether your install can run it.
Try: “Save the default text-to-image template to ./wf.json”
Write ·
fetch_templateLists or searches the model files on your disk
Lists the model files in your ComfyUI models folders, or searches them by name.
Try: “Which LoRAs do I have installed?”
Files ·
search_modelsSearches your installed nodes and shows how they connect
Searches the node types in your running ComfyUI, custom nodes included, shows a node's inputs and outputs, and finds which nodes can connect to each other.
Try: “Which node can turn a latent into an image?”
Read ·
nodesLists the paid hosted models you can generate with
Lists the hosted partner models available for generation, filterable by style, partner or keyword.
Try: “Which partner models can make video from an image?”
Network ·
list_partner_modelsShows the settings a partner model accepts
Shows what settings and inputs one partner model takes, without running it or spending credits.
Try: “What settings does Kling image-to-video take?”
Network ·
partner_model_schemaChecks a workflow for missing nodes or models before you run it
Checks a workflow file against your ComfyUI and lists problems such as missing models or wrong values, with suggestions for what you have instead.
Try: “Check ./wf.json before running it”
Files ·
validate_workflowLists the settings you can change in a workflow
Lists the values in a workflow that can be changed, such as prompt, seed, steps or model, with their current values.
Try: “What can I change in this workflow?”
Files ·
list_workflow_slotsReads the notes a template's author left inside it
Reads the notes written inside a workflow, such as trigger words, model download links and usage tips.
Try: “Does this template say which models I need?”
Files ·
list_workflow_notesChanges settings like prompt, seed or steps in a workflow
Changes values in a workflow, such as the prompt, seed, steps or model, and returns the edited workflow without overwriting the file by default.
Try: “Set the seed to 42 and steps to 30 in ./wf.json”
Write ·
set_workflow_slotMakes several versions of a workflow with different settings
Creates a set of workflow variants from lists of values, for example several prompts or seeds, so you can run them as a batch.
Try: “Make three versions of this workflow with different prompts”
Write ·
vary_workflowFinds which custom node packs a workflow needs
Works out which custom node packs a workflow uses and which of them you have not installed yet.
Try: “Which node packs do I need for this workflow?”
Files ·
workflow_depsChecks whether a node pack's Python requirements are met
Compares a custom node pack's required Python packages with what is installed, before or after you install the pack.
Try: “Why are the Impact Pack nodes failing to load?”
Files ·
node_dependenciesPuts your images or masks into ComfyUI's input folder
Copies images or masks from your computer into ComfyUI's input folder so workflows like image-to-image or inpainting can use them.
Try: “Upload ~/Pictures/cat.png so we can restyle it”
Write ·
upload_fileDownloads a model file from a direct link into your models folder
Downloads a model file from a direct Hugging Face or CivitAI link into your ComfyUI models folder, in the background.
Try: “Download this LoRA from Hugging Face into models/loras”
Write ·
download_modelInstalls custom node packs from the registry, after you approve
Installs custom node packs from the Comfy registry into your ComfyUI. It runs the packs' own install code, so it asks you every time.
Try: “Install comfyui-impact-pack”
Runs code ·
install_nodeUpdates ComfyUI, its custom nodes or comfy-cli
Updates ComfyUI itself, comfy-cli, or all installed custom node packs. Updating all node packs asks you first because it runs their new code.
Try: “Update ComfyUI to the latest version”
Runs code ·
update_comfyuiMoves ComfyUI to a specific version, after you approve
Switches your ComfyUI install to a chosen version, for example to roll back after a bad update. It stashes local edits, reinstalls dependencies and asks you first.
Try: “Roll ComfyUI back to version 0.24.0”
Delete ·
switch_comfyui_versionStarts ComfyUI in the background
Starts your local ComfyUI in the background. Opening it to your network asks you first, because ComfyUI has no login.
Try: “Start ComfyUI”
Runs code ·
launch_comfyuiStops the ComfyUI it started
Stops the ComfyUI that comfy-cli started earlier.
Try: “Stop ComfyUI”
Runs code ·
stop_comfyuiRestarts ComfyUI, for example after installing nodes
Stops and starts ComfyUI again, with new options if you give them. It asks before stopping a ComfyUI it did not start.
Try: “Restart ComfyUI so the new nodes load”
Runs code ·
restart_comfyuiFrees graphics memory by unloading ComfyUI's models
Asks ComfyUI to unload its models and clear its cache to free graphics memory, without stopping a running job.
Try: “Free up VRAM before the next video run”
Write ·
free_memoryShows free graphics memory and RAM on your ComfyUI
Reports how much graphics memory and system memory your running ComfyUI has free.
Try: “How much VRAM is free right now?”
Read ·
system_statsShows your Comfy credit balance and plan
Shows your Comfy Cloud credit balance, subscription plan, renewal date and how many jobs you can run at once. It spends nothing.
Try: “How many Comfy credits do I have left?”
Network ·
billing_statusStarts signing you in to your Comfy account
Starts a Comfy account sign-in and gives you a link to open in your browser, needed for paid partner nodes.
Try: “Sign me in to Comfy”
Network ·
auth_loginChecks whether you are signed in to Comfy
Checks whether a Comfy account sign-in or API key is set up, without showing any secrets.
Try: “Am I signed in to Comfy?”
Network ·
auth_statusShows the latest lines of ComfyUI's log
Shows the most recent lines from the background ComfyUI's log file, useful when something fails.
Try: “Show me the last 100 lines of the ComfyUI log”
Files ·
get_logsChecks, waits for, follows or cancels a generation job
Checks a job's status, waits for it to finish, streams its progress, explains why it failed, cancels it, or lists the queue.
Try: “Why did that last job fail?”
Write ·
jobChecks progress of a model download, or cancels it
Shows how far a model download has got, waits for it to finish, or cancels it and removes the partial file.
Try: “Is the checkpoint download finished?”
Delete ·
downloadWrites a workflow that runs a partner model through your ComfyUI
Writes a workflow file that uses a partner model's node, so your own ComfyUI runs it. Writing it is free; running it spends credits.
Try: “Write a Nano Banana workflow I can edit and run locally”
Write ·
emit_partner_workflowUsed by the assistant behind the scenes
Checks whether ComfyUI is running and what hardware you have
Reports whether your ComfyUI is running, where, which workspace it uses, your graphics card and memory, and whether ComfyUI or nodes are out of date.
Try: “Is my ComfyUI running?”
Read ·
server_infoShows which ComfyUI install it is pointed at
Shows which ComfyUI install and workspace comfy-cli is set to use.
Try: “Which ComfyUI folder are you using?”
Read ·
whichShows or sets up the project folder it works in
Reports or creates the project setting that tells the server which folder relative paths start from.
Try: “Set up a Comfy project in this folder”
Write ·
projectReads comfy-cli's own command reference
Loads comfy-cli's description of its own commands so the assistant can learn what it supports.
Try: “What commands does comfy-cli support?”
Read ·
discover
Read from the source code
Pros and cons
Good
- Made and maintained by Comfy Org, the team behind ComfyUI.
- The cloud connection needs no install, no ComfyUI and no GPU.
- The local connection sees your own models, LoRAs and custom nodes, not a fixed catalog.
- Local runs on your own hardware are free, apart from partner models.
- Spending credits, installing nodes and exposing ComfyUI to the network each ask you first.
- Browser sign-in for Claude Code, Claude Desktop and Codex, with an API key option for Cursor and scripts.
Watch out
- Cloud generations need an active Comfy Cloud subscription; credits alone are not enough.
- Comfy still calls it an early release, with known gaps in workflow building and file handling.
- The local server needs Python, comfy-cli and a running ComfyUI, which trips up Windows and Comfy Desktop users.
- When a local tool fails, the client often sees only a bare error with no reason.
- Cloud results do not land on your machine until the agent runs a download command.
- No read-only mode.
Permissions
medium risk · 5 things to watch
Medium risk
The assistant can spend Comfy credits on partner models and install third-party node code into your ComfyUI. Approve each spend and install prompt yourself, and keep ComfyUI off the network unless you need it there.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Partner models spend your Comfy credits
Hosted partner models bill credits on every run, and workflows with partner nodes spend once you confirm. Custom nodes that call their own paid services are not gated, so check workflows you did not build. github.com
It can install and run third-party node code
Installing node packs or updating all of them runs code from their authors in your ComfyUI setup. Each call asks you first; approve only packs you know. github.com
ComfyUI has no login of its own
Starting ComfyUI on a network address lets anyone who can reach your machine run workflows and read or write its files. The server asks before doing that; say no unless you need it. github.com
Version switches can stash your local edits
Moving ComfyUI to another version stashes uncommitted changes in its folder and reinstalls its dependencies. It asks first and refuses while ComfyUI is running. github.com
Cloud downloads run a command in your shell
The cloud server hands your agent a signed link and a curl command to save the file. Check where the command saves it before you approve it. docs.comfy.org
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Talks to | Comfy Cloud (cloud connection, partner models). Partner model providers when you run partner models. Model and node downloads you ask for (Hugging Face, CivitAI, the Comfy registry) |
|---|
Alternatives
Use Comfy MCP if you want Comfy Cloud or Comfy's own local server. The community servers are the pick if you want a different take on driving a local ComfyUI and do not need Comfy Cloud.
| Server | Official | Runs | Sign-in | Tools | GitHub stars |
|---|---|---|---|---|---|
| For ComfyUI | |||||
| Comfy MCPThis page | Official | HostedLocal | Account | 41 | 317 |
| comfyui-mcp-server | Community | Local | – | – | 411 |
| Other tools for the same job | |||||
| comfyui-mcp (artokun) | Community | Local | – | – | 879 |
What people say
Early users mostly talk about setup friction on the local server and unclear error messages.
What people like
- Comfy pitches the cloud connection as image and video generation with no nodes, downloads or GPU.
Common complaints
- Local tool failures reach the assistant as a bare error, so it cannot tell what went wrong.
- With Comfy Desktop the port changes between launches, so the server can quietly target the wrong address.
- Windows users report trouble installing it next to Comfy Desktop.
Questions
Is Comfy MCP free?
Partly. Searching templates, models and nodes is free with a Comfy account. Cloud generations need an active Comfy Cloud subscription (new accounts get 5 free runs), and local runs are free except partner models, which spend credits.
What is the Comfy MCP server URL?
The cloud connection is https://cloud.comfy.org/mcp. The local connection has no URL: your app starts the comfy-mcp program on your computer.
Should I use the cloud or the local connection?
Start with the cloud if you are new, on a Mac, or use claude.ai, ChatGPT or Claude Desktop chat. Use local if you already run ComfyUI or work in a coding agent. You can add both and say where each job should run.
Does the cloud connection have the same tools as the local one?
No. The tool list on this page is the local server's 41 tools. The cloud connection has its own set for templates, running workflows, batches, saved workflows, sharing and billing, listed in Comfy's docs.
Do I need an API key?
Not in Claude Code, Claude Desktop or Codex, which sign you in through the browser. Cursor and setups with no browser need a Comfy Cloud API key.
Can my computer run the local connection?
With 24 GB or more of graphics memory it handles video. Between 8 and 24 GB is fine for images, and under 8 GB or on a Mac, Comfy recommends the cloud.
Can it spend money without asking?
Not by default. Partner models and paid workflows ask you before each run, unless you tell comfy-cli to always allow partner spending. Custom nodes that bill their own services are not checked.
Where do my generated files go?
Locally, ComfyUI saves them in its output folder and the assistant can copy them where you ask. On the cloud, the assistant runs a download command it is given; if your app cannot run commands, run it yourself.
Why does Codex keep asking me to sign in?
It is a Codex bug when several Codex sessions refresh the same sign-in. Turn on Codex's refresh coordination setting, keep the server in one project, or use an API key instead.
Do the slash commands work in Claude Desktop?
No. They come with the Claude Code plugin. In Claude Desktop, use the prompt picker or just ask in plain words.
Examples
Run a workflow file on your local ComfyUI and see the image
Confirm my local ComfyUI is running, then run the workflow at ~/workflows/txt2img.json and show me the image.
SourceGenerate an image on Comfy Cloud from a plain description
generate an image of a cat astronaut
SourceFind a ready-made video template to start from
find a Wan 2.2 video template
Source
Information
updated Nov 2, 2026
- Publisher
- Comfy Org (official)
- Package
comfy-mcp- Registry
- PyPI
- Transport
- stdio, Streamable HTTP
- Auth
- OAuth
- Version
- 0.10.0
- License
- Apache-2.0
- Last commit
- Oct 30, 2026
- Open issues
- 14
Other ComfyUI MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 10Hide
- docs.comfy.org · docs.comfy.org
- github.com · github.com
- blog.comfy.org · blog.comfy.org
- github.com · github.com
- Unreliable run workflow, Error executing tool run_workflow · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com