Clo3d Mcp
MCP server for CLO3D. Control 3D garment design from Claude, Cursor, or any MCP client.
- Transport
- Not stated
- Package
- —
- Registry id
- —
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
Talk to CLO3D from Claude, Cursor, or any MCP client. Create patterns, swap fabrics, run simulations, export models. All from a chat window.
If you use CLO3D and you've wished you could script repetitive tasks without digging through the API docs, this is for you.
Your AI assistant <--> MCP Server <--> CLO3D Plugin <--> CLO3D
Quick Start
1. Load the plugin in CLO3D
One Python file, no dependencies.
- Open CLO3D
- Script > Script Editor
- Open
plugin/clo3d_mcp_plugin.py - Hit Run
You'll see [CLO MCP] Plugin started and [CLO MCP] Listening for commands in: ... in the console.
Run it once per CLO3D session. On Windows the plugin listens through a native timer driven by CLO3D's own event loop, so CLO3D stays fully usable. On other platforms it falls back to a blocking loop: the Script Editor stays busy while the plugin listens. Re-running the script replaces the previous listener.
2. Connect your AI client
Claude Code:
claude mcp add clo3d -- uvx --from git+https://github.com/Ubani-Studio/clo3d-mcp clo3d-mcp
Claude Desktop (add to claude_desktop_config.json):
{
"mcpServers": {
"clo3d": {
"command": "uvx",
"args": ["--from", "git+https://github.com/Ubani-Studio/clo3d-mcp", "clo3d-mcp"]
}
}
}
3. Go
Ask things like:
- "What patterns are in this project?"
- "Set the front bodice fabric to red"
- "Run 100 steps of simulation then export as GLB"
- "Export a turntable of all colorways"
What you get (46 tools)
Scene
| Tool | What it does |
|---|---|
get_project_info |
Project name, file path, CLO version, piece counts |
new_project |
Start fresh |
open_file |
Open .zprj, .zpac, .obj, .fbx, .avt |
save_project |
Save as .zprj |
get_garment_info |
Dump full garment metadata to JSON |
Patterns
| Tool | What it does |
|---|---|
get_pattern_count |
How many pieces |
get_pattern_list |
All pieces with names and indices |
get_pattern_info |
Full detail on one piece |
get_pattern_bounding_box |
Width and height |
set_pattern_name |
Rename a piece |
copy_pattern |
Duplicate at a given position |
delete_pattern |
Remove a piece |
flip_pattern |
Flip horizontal or vertical |
create_pattern |
Build a new piece from vertex points |
get_arrangement_list |
Get avatar arrangement points |
Fabrics
| Tool | What it does |
|---|---|
get_fabric_list |
All fabrics with indices |
add_fabric |
Load a .zfab or .jfab |
replace_fabric |
Swap an existing fabric |
assign_fabric_to_pattern |
Put a fabric on a pattern piece |
set_fabric_color |
Set PBR base color (RGB) |
get_fabric_for_pattern |
Check which fabric is on a piece |
Export
| Tool | What it does |
|---|---|
export_obj |
OBJ with options |
export_fbx |
FBX |
export_glb |
GLB (binary glTF) |
export_gltf |
glTF |
export_thumbnail |
3D viewport screenshot |
export_snapshot |
Multi-view snapshots |
export_turntable |
360 turntable image sequence |
export_tech_pack |
Tech pack with JSON + images |
Import
| Tool | What it does |
|---|---|
import_file |
Auto-detect and import any supported format |
Simulation
| Tool | What it does |
|---|---|
simulate |
Run cloth sim for N steps |
Colorways
| Tool | What it does |
|---|---|
get_colorways |
List all colorways |
set_current_colorway |
Switch the active colorway |
How it works
Two pieces:
The plugin (plugin/clo3d_mcp_plugin.py) runs inside CLO3D. It's a single Python file that polls a shared temp directory for JSON commands, calls the CLO3D Python API, and writes results back. No external dependencies, no sockets, works with CLO3D's built-in Python.
From the project's README.