Houdini MCP Server
Enables natural language control of SideFX Houdini for tasks including node management, parameter editing, and geometry inspection. It leverages RPYC to execute Python scripts and manage scene data through an MCP-compatible interface.
Ask AI about Houdini MCP Server
Powered by Claude Β· Grounded in docs
I know everything about Houdini MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Houdini MCP Server
Control SideFX Houdini from AI assistants via the Model Context Protocol.
35 tools for node creation, parameter editing, geometry inspection, scene management, and arbitrary Python execution β all driven by natural language through Claude or any MCP-compatible client.
Features
- Node operations β create, delete, rename, connect, layout, cook, find nodes
- Parameter control β get/set values, list parameters, set expressions
- Geometry inspection β read points, primitives, bounding boxes, export
.geo - Scene management β new/open/save scenes, scene info
- Transform tools β get/set object transforms
- Code execution β run arbitrary Python or HScript inside Houdini
- Built-in documentation β 11 comprehensive HOM reference docs + 5 index files, searchable via MCP tools
Prerequisites
Setup
1. Start RPYC server in Houdini
Open Houdini's Python Shell (Windows > Python Shell) and run:
import hrpyc
hrpyc.start_server(port=18811)
Or use the provided helper script:
exec(open("/path/to/houdini-mcp/houdini_setup.py").read())
2. Configure your MCP client
Add to your MCP client configuration (e.g., .mcp.json for Claude Code):
{
"mcpServers": {
"houdini": {
"command": "uv",
"args": ["--directory", "/path/to/houdini-mcp", "run", "server.py"]
}
}
}
Replace /path/to/houdini-mcp with the actual path to this repo.
3. Connect
Call the houdini_connect tool first. Then use any of the 35 available tools.
Claude Code Skill (Optional)
The claude-skill/ directory contains a Houdini Python reference skill for Claude Code. To use it:
- Copy
claude-skill/houdini-python.mdto your project's.claude/commands/directory - The skill provides HOM API reference, SOP/DOP/VOP node guides, and scripting patterns
- Invoke with
/houdini-pythonin Claude Code
Tools
| Category | Tools |
|---|---|
| Connection | houdini_connect, houdini_disconnect |
| Scene | houdini_scene_new, houdini_scene_open, houdini_scene_save, houdini_scene_info |
| Nodes | houdini_node_create, houdini_node_delete, houdini_node_rename, houdini_node_connect, houdini_node_cook, houdini_node_info, houdini_node_children, houdini_node_find, houdini_node_layout, houdini_node_set_flags |
| Parameters | houdini_parm_get, houdini_parm_set, houdini_parm_list, houdini_parm_set_expression |
| Geometry | houdini_geo_info, houdini_geo_read_points, houdini_geo_read_prims, houdini_geo_bbox, houdini_geo_export |
| Transforms | houdini_transform_get, houdini_transform_set |
| Execution | houdini_execute, houdini_hscript |
| Frame | houdini_set_frame |
How it works
ββββββββββββββββ MCP (stdio) ββββββββββββββββ RPYC (TCP) ββββββββββββββββ
β AI Client β βββββββββββββββββββΊ β MCP Server β ββββββββββββββββββΊ β Houdini β
β (Claude etc) β β (server.py) β β (port 18811)β
ββββββββββββββββ ββββββββββββββββ ββββββββββββββββ
The MCP server translates tool calls into RPYC remote procedure calls to Houdini's Python interpreter. Houdini runs an RPYC server (via hrpyc) that exposes the full hou module.
License
MIT
