n8n-nodes-comfyui-toolkit

Connect ComfyUI to your n8n workflows. Generate images and videos, upload reference images, poll for results, and download outputs — all without leaving n8n.

Nodes

Typical Workflows

Text to Image

[Trigger] ──► [Text to Image] ──► [Wait Until Result] ──► [Get Results]

Image to Image / Image to Video

[Trigger] ──► [Upload Image] ──► [Image to Image] ──► [Wait Until Result] ──► [Get Results]

Prerequisites

• n8n ≥ 1.0.0 (self-hosted)
• ComfyUI running and reachable from your n8n instance
• A ComfyUI workflow exported in API format

To export a workflow in API format: enable Dev Mode in ComfyUI settings (gear icon → Enable Dev Mode Options), then use Save (API Format).

Installation

Via n8n Community Nodes UI (recommended)

1. Open n8n → Settings → Community Nodes
2. Click Install and enter: n8n-nodes-comfyui-toolkit
3. Confirm and restart n8n when prompted

Via Docker

docker exec -it n8n sh -c "cd /home/node/.n8n/nodes && npm install n8n-nodes-comfyui-toolkit"
docker restart n8n

Via npm (self-hosted without Docker)

cd ~/.n8n/nodes
npm install n8n-nodes-comfyui-toolkit

Then restart n8n.

Node Reference

ComfyUI Upload Image

Output: all input JSON fields plus filename, subfolder, type, comfyui_url.

ComfyUI Text to Image / Image to Image / Text to Video / Image to Video

All four generation nodes share the same parameters:

Output: prompt_id, session_id, submitted: true, comfyui_url.

ComfyUI Wait Until Result

Output (one item per file): filename, type, subfolder, media_type, node_id, file_index, total_files, duration_ms, prompt_id, session_id, completed: true, comfyui_url.

Note: If ComfyUI completes a job in 0.00 s (identical workflow submitted twice with the same seed), this node throws immediately with a descriptive error rather than waiting for the full timeout. Use a random seed in your workflow to prevent deduplication.

ComfyUI Get Results

Accepts all items output by Wait Until Result and aggregates them into a single output item.

Output: success, prompt_id, unique_id, total_files, imageUrl[].

Each entry in imageUrl: filename, type, subfolder, media_type, data (base64-encoded file content).

Troubleshooting

Node not appearing in n8n after installation

• Restart n8n after installing the package.
• Verify the package is listed under Settings → Community Nodes.

Connection refused or ECONNREFUSED errors

• If n8n runs in Docker, use http://host.docker.internal:8188 instead of http://localhost:8188.
• Confirm ComfyUI is running and accessible from the n8n container: curl http://host.docker.internal:8188/system_stats.

Wait Until Result times out

• Increase the Timeout parameter.
• Check ComfyUI's queue — another job may be blocking yours.
• Make sure ComfyUI has a GPU available; CPU-only generation can take several minutes.

prompt_id not returned error

• Ensure your Workflow JSON is valid ComfyUI API format. Export it fresh from ComfyUI using Save (API Format).
• The node accepts both {"prompt":{…}} and the bare {…} prompt object.

Duplicate workflow / 0.00 s completion

• ComfyUI deduplicates identical workflows with the same seed. Add a random seed to your workflow to force re-execution.

Development

git clone https://github.com/federal1789/n8n-nodes-comfyui-toolkit.git
cd n8n-nodes-comfyui-toolkit
npm install

npm run build   # compile TypeScript → dist/
npm test        # run Jest tests
npm run lint    # ESLint

Publishing a new version

1. Bump the version in package.json
2. Commit and push
3. Create a git tag:

   git tag v1.x.x
   git push --tags
   

GitHub Actions will build, test, and publish to npm automatically.

To configure publishing, add your npm token as a repository secret named NPM_TOKEN in GitHub → Settings → Secrets and variables → Actions.

Contributing

Pull requests are welcome! See CONTRIBUTING.md for guidelines.

Security

To report a vulnerability, see SECURITY.md.

License

MIT © Ilker Umut