How do I install Comfy Pilot?

You can install it via the ComfyUI CLI with 'comfy node install comfy-pilot', via ComfyUI Manager's custom nodes interface, or by cloning the GitHub repo into ComfyUI's custom_nodes folder.

What are the requirements to run this MCP server?

You need ComfyUI and Python 3.8 or higher installed.

Can this server download models from external sources?

Yes, it supports downloading models from Hugging Face (including gated models with token authentication), CivitAI, and direct URLs.

How does the embedded terminal work?

It uses xterm.js in the browser to run a PTY process with the Claude CLI, allowing interactive AI commands inside ComfyUI.

Comfy Pilot

comfyuiimage-generationworkflowmcpclaude

MCP server enabling AI agents to view, edit, and run ComfyUI node-based image workflows with an embedded terminal.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for ConstantineB6/comfy-pilot, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Overview

This MCP server integrates with ComfyUI to allow AI agents, specifically Claude Code, to interact programmatically with node-based image generation workflows. It provides capabilities to view, modify, and execute workflows, as well as download models and manage custom nodes. Use it when you want to automate or enhance ComfyUI workflows via AI-driven commands and an embedded terminal interface.

Use cases

Create and connect nodes in ComfyUI workflows programmatically

View and analyze output images from workflow nodes

Download and install models from Hugging Face, CivitAI, or URLs

Manage custom nodes by searching, installing, updating, or uninstalling

Run or interrupt workflow execution up to specific nodes

Key features

MCP server exposing ComfyUI workflow state and control

Embedded xterm.js terminal running Claude Code inside ComfyUI

Image viewing from Preview Image and Save Image nodes

Programmatic graph editing: create, delete, move, connect, configure nodes

Model downloading with support for gated Hugging Face tokens

Custom node registry management (search/install/update/uninstall)

Capabilities & Tool Schemas (13)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Comfy Pilot.

get_workflow

Get the current workflow from the browser

summarize_workflow

Human-readable workflow summary

get_node_types

Search available node types with filtering

get_node_info

Get detailed info about a specific node type

get_status

Queue status, system stats, and execution history

run

Run workflow (optionally up to a specific node) or interrupt

Documentation Overview

Comfy Pilot

Talk to your ComfyUI workflows. Comfy Pilot gives Claude Code direct access to see, edit, and run your workflows — with an embedded terminal right inside ComfyUI.

Why?

Building ComfyUI workflows means manually searching for nodes, dragging connections, and tweaking values one at a time. With Comfy Pilot, you just describe what you want:

"Build me an SDXL workflow with ControlNet" — Claude creates all the nodes, connects them, and sets the parameters
"Look at the output and increase the detail" — Claude sees your generated image and adjusts the workflow
"Download the FLUX schnell model and set up a workflow for it" — Claude downloads the model and builds a workflow from scratch

No copy-pasting node names. No hunting through menus. Just say what you want.

Installation

CLI (Recommended):

bash

comfy node install comfy-pilot

ComfyUI Manager:

Open ComfyUI
Click Manager → Install Custom Nodes
Search for "Comfy Pilot"
Click Install
Restart ComfyUI

Git Clone:

bash

cd ~/Documents/ComfyUI/custom_nodes && git clone https://github.com/ConstantineB6/comfy-pilot.git

Claude Code CLI will be installed automatically if not found.

Requirements

ComfyUI
Python 3.8+

Features

MCP Server - Gives Claude Code direct access to view, edit, and run your ComfyUI workflows
Embedded Terminal - Full xterm.js terminal running Claude Code right inside ComfyUI
Image Viewing - Claude can see outputs from Preview Image and Save Image nodes
Graph Editing - Create, delete, move, and connect nodes programmatically

Demo

https://github.com/user-attachments/assets/325b1194-2334-48a1-94c3-86effd1fef02

Usage

Restart ComfyUI after installation
The floating Claude Code terminal appears in the top-right corner
The MCP server is automatically configured for Claude Code
Ask Claude to help with your workflow:
- "What nodes are in my current workflow?"
- "Add a KSampler node connected to my checkpoint loader"
- "Look at the preview image and tell me what you see"
- "Run the workflow up to node 5"

MCP Tools

The MCP server provides these tools to Claude Code:

Tool	Description
`get_workflow`	Get the current workflow from the browser
`summarize_workflow`	Human-readable workflow summary
`get_node_types`	Search available node types with filtering
`get_node_info`	Get detailed info about a specific node type
`get_status`	Queue status, system stats, and execution history
`run`	Run workflow (optionally up to a specific node) or interrupt
`edit_graph`	Batch create, delete, move, connect, and configure nodes
`view_image`	View images from Preview Image / Save Image nodes
`search_custom_nodes`	Search ComfyUI Manager registry for custom nodes
`install_custom_node`	Install a custom node from the registry
`uninstall_custom_node`	Uninstall a custom node
`update_custom_node`	Update a custom node to latest version
`download_model`	Download models from Hugging Face, CivitAI, or direct URLs

Example: Creating Nodes

Code

Create a KSampler and connect it to my checkpoint loader

Claude will use edit_graph to:

Create the KSampler node
Connect the MODEL output from CheckpointLoader to KSampler's model input
Position it appropriately in the graph

Example: Viewing Images

Code

Look at the preview image and describe what you see

Claude will use view_image to fetch and analyze the image output.

Example: Downloading Models

Code

Download the FLUX.1 schnell model for me

Claude will use download_model to download from Hugging Face to your ComfyUI models folder. Supports:

Hugging Face (including gated models with token auth)
CivitAI
Direct download URLs

Terminal Controls

Drag title bar to move
Drag bottom-right corner to resize
− Minimize
× Close
↻ Reconnect session

Architecture

Code

┌─────────────────────────────────────────────────────┐
│  Browser (ComfyUI)                                  │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  xterm.js       │  │  Workflow State          │  │
│  │  Terminal       │  │  (synced to backend)     │  │
│  └────────┬────────┘  └────────────┬─────────────┘  │
│           │ WebSocket              │ REST API       │
└───────────┼────────────────────────┼────────────────┘
            │                        │
            ▼                        ▼
┌─────────────────────────────────────────────────────┐
│  ComfyUI Server                                     │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  PTY Process    │  │  Plugin Endpoints        │  │
│  │  (claude CLI)   │  │  /claude-code/*          │  │
│  └─────────────────┘  └──────────────────────────┘  │
└─────────────────────────────────────────────────────┘
            │                        │
            │                        ▼
            │           ┌──────────────────────────┐
            └──────────▶│  MCP Server              │
                        │  (stdio transport)       │
                        └──────────────────────────┘

Files

__init__.py - Plugin backend: WebSocket terminal, REST endpoints
js/claude-code.js - Frontend: xterm.js terminal, workflow sync
mcp_server.py - MCP server for Claude Code integration
CLAUDE.md - Instructions for Claude when working with ComfyUI

Troubleshooting

"Command 'claude' not found"

Install Claude Code CLI:

macOS / Linux / WSL:

Terminal

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

powershell

irm https://claude.ai/install.ps1 | iex

Windows (CMD):

Terminal

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

MCP server not connecting

The plugin auto-configures MCP on startup. Check ComfyUI console for errors, or manually add to ~/.claude.json:

config.json

{
  "mcpServers": {
    "comfyui": {
      "command": "python3",
      "args": ["/path/to/comfy-pilot/mcp_server.py"]
    }
  }
}

Terminal disconnected

Click the ↻ button to reconnect, or check ComfyUI console for errors.

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Art & Culture View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

231

Stargazers on the source repository.

Last commit

6mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Comfy Pilot

It is designed to integrate with Claude Code, providing direct access to ComfyUI workflows and an embedded terminal.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/constantineb6-comfy-pilot?style=directory)](https://allmcps.com/mcp/constantineb6-comfy-pilot)

HTML Embed

<a href="https://allmcps.com/mcp/constantineb6-comfy-pilot"><img src="https://allmcps.com/api/badge/constantineb6-comfy-pilot?style=directory" alt="Comfy Pilot on AllMCPs" /></a>

Technical Specs & Signals

CategoryArt & Culture

PricingFree

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools23/30

Adoption & activity5/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🎨 Art & Culture →Alternatives to Comfy Pilot →Install in Claude Desktop Install in Cursor Install in VS Code

Comfy Pilot

comfyuiimage-generationworkflowmcpclaude

MCP server enabling AI agents to view, edit, and run ComfyUI node-based image workflows with an embedded terminal.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Overview

Use cases

Create and connect nodes in ComfyUI workflows programmatically

View and analyze output images from workflow nodes

Download and install models from Hugging Face, CivitAI, or URLs

Manage custom nodes by searching, installing, updating, or uninstalling

Run or interrupt workflow execution up to specific nodes

Key features

MCP server exposing ComfyUI workflow state and control

Embedded xterm.js terminal running Claude Code inside ComfyUI

Image viewing from Preview Image and Save Image nodes

Programmatic graph editing: create, delete, move, connect, configure nodes

Model downloading with support for gated Hugging Face tokens

Custom node registry management (search/install/update/uninstall)

Capabilities & Tool Schemas (13)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Comfy Pilot.

get_workflow

Get the current workflow from the browser

summarize_workflow

Human-readable workflow summary

get_node_types

Search available node types with filtering

get_node_info

Get detailed info about a specific node type

get_status

Queue status, system stats, and execution history

run

Run workflow (optionally up to a specific node) or interrupt

Documentation Overview

Comfy Pilot

Talk to your ComfyUI workflows. Comfy Pilot gives Claude Code direct access to see, edit, and run your workflows — with an embedded terminal right inside ComfyUI.

Why?

Building ComfyUI workflows means manually searching for nodes, dragging connections, and tweaking values one at a time. With Comfy Pilot, you just describe what you want:

"Build me an SDXL workflow with ControlNet" — Claude creates all the nodes, connects them, and sets the parameters
"Look at the output and increase the detail" — Claude sees your generated image and adjusts the workflow
"Download the FLUX schnell model and set up a workflow for it" — Claude downloads the model and builds a workflow from scratch

No copy-pasting node names. No hunting through menus. Just say what you want.

Installation

CLI (Recommended):

bash

comfy node install comfy-pilot

ComfyUI Manager:

Open ComfyUI
Click Manager → Install Custom Nodes
Search for "Comfy Pilot"
Click Install
Restart ComfyUI

Git Clone:

bash

cd ~/Documents/ComfyUI/custom_nodes && git clone https://github.com/ConstantineB6/comfy-pilot.git

Claude Code CLI will be installed automatically if not found.

Requirements

ComfyUI
Python 3.8+

Features

MCP Server - Gives Claude Code direct access to view, edit, and run your ComfyUI workflows
Embedded Terminal - Full xterm.js terminal running Claude Code right inside ComfyUI
Image Viewing - Claude can see outputs from Preview Image and Save Image nodes
Graph Editing - Create, delete, move, and connect nodes programmatically

Demo

https://github.com/user-attachments/assets/325b1194-2334-48a1-94c3-86effd1fef02

Usage

Restart ComfyUI after installation
The floating Claude Code terminal appears in the top-right corner
The MCP server is automatically configured for Claude Code
Ask Claude to help with your workflow:
- "What nodes are in my current workflow?"
- "Add a KSampler node connected to my checkpoint loader"
- "Look at the preview image and tell me what you see"
- "Run the workflow up to node 5"

MCP Tools

The MCP server provides these tools to Claude Code:

Tool	Description
`get_workflow`	Get the current workflow from the browser
`summarize_workflow`	Human-readable workflow summary
`get_node_types`	Search available node types with filtering
`get_node_info`	Get detailed info about a specific node type
`get_status`	Queue status, system stats, and execution history
`run`	Run workflow (optionally up to a specific node) or interrupt
`edit_graph`	Batch create, delete, move, connect, and configure nodes
`view_image`	View images from Preview Image / Save Image nodes
`search_custom_nodes`	Search ComfyUI Manager registry for custom nodes
`install_custom_node`	Install a custom node from the registry
`uninstall_custom_node`	Uninstall a custom node
`update_custom_node`	Update a custom node to latest version
`download_model`	Download models from Hugging Face, CivitAI, or direct URLs

Example: Creating Nodes

Code

Create a KSampler and connect it to my checkpoint loader

Claude will use edit_graph to:

Create the KSampler node
Connect the MODEL output from CheckpointLoader to KSampler's model input
Position it appropriately in the graph

Example: Viewing Images

Code

Look at the preview image and describe what you see

Claude will use view_image to fetch and analyze the image output.

Example: Downloading Models

Code

Download the FLUX.1 schnell model for me

Claude will use download_model to download from Hugging Face to your ComfyUI models folder. Supports:

Hugging Face (including gated models with token auth)
CivitAI
Direct download URLs

Terminal Controls

Drag title bar to move
Drag bottom-right corner to resize
− Minimize
× Close
↻ Reconnect session

Architecture

Code

┌─────────────────────────────────────────────────────┐
│  Browser (ComfyUI)                                  │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  xterm.js       │  │  Workflow State          │  │
│  │  Terminal       │  │  (synced to backend)     │  │
│  └────────┬────────┘  └────────────┬─────────────┘  │
│           │ WebSocket              │ REST API       │
└───────────┼────────────────────────┼────────────────┘
            │                        │
            ▼                        ▼
┌─────────────────────────────────────────────────────┐
│  ComfyUI Server                                     │
│  ┌─────────────────┐  ┌──────────────────────────┐  │
│  │  PTY Process    │  │  Plugin Endpoints        │  │
│  │  (claude CLI)   │  │  /claude-code/*          │  │
│  └─────────────────┘  └──────────────────────────┘  │
└─────────────────────────────────────────────────────┘
            │                        │
            │                        ▼
            │           ┌──────────────────────────┐
            └──────────▶│  MCP Server              │
                        │  (stdio transport)       │
                        └──────────────────────────┘

Files

__init__.py - Plugin backend: WebSocket terminal, REST endpoints
js/claude-code.js - Frontend: xterm.js terminal, workflow sync
mcp_server.py - MCP server for Claude Code integration
CLAUDE.md - Instructions for Claude when working with ComfyUI

Troubleshooting

"Command 'claude' not found"

Install Claude Code CLI:

macOS / Linux / WSL:

Terminal

curl -fsSL https://claude.ai/install.sh | bash

Windows (PowerShell):

powershell

irm https://claude.ai/install.ps1 | iex

Windows (CMD):

Terminal

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

MCP server not connecting

The plugin auto-configures MCP on startup. Check ComfyUI console for errors, or manually add to ~/.claude.json:

config.json

{
  "mcpServers": {
    "comfyui": {
      "command": "python3",
      "args": ["/path/to/comfy-pilot/mcp_server.py"]
    }
  }
}

Terminal disconnected

Click the ↻ button to reconnect, or check ComfyUI console for errors.

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Art & Culture View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

231

Stargazers on the source repository.

Last commit

6mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Comfy Pilot

It is designed to integrate with Claude Code, providing direct access to ComfyUI workflows and an embedded terminal.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/constantineb6-comfy-pilot?style=directory)](https://allmcps.com/mcp/constantineb6-comfy-pilot)

HTML Embed

<a href="https://allmcps.com/mcp/constantineb6-comfy-pilot"><img src="https://allmcps.com/api/badge/constantineb6-comfy-pilot?style=directory" alt="Comfy Pilot on AllMCPs" /></a>

Technical Specs & Signals

CategoryArt & Culture

PricingFree

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools23/30

Adoption & activity5/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🎨 Art & Culture →Alternatives to Comfy Pilot →Install in Claude Desktop Install in Cursor Install in VS Code