
Houdini MCP
io.github.JTCHEv0.7.3Updated Oct 4, 2026
Connect agents to SideFX Houdini: edit the scene, cook, render, see the viewport, read the docs.
Overview
Lets an AI assistant drive a local SideFX Houdini session: inspect and edit scenes, cook, render, capture the viewport, and read offline docs.
- What it does
- The server bridges an assistant to SideFX Houdini running on the same machine. Read tools cover scene overview, node, geometry and stage inspection, selection and console output; edit tools cover node editing, parameter setting, connections, HDAs and batch network builds. Run tools cook, render, run PDG and control the playbar and scene files, capture takes viewport, camera, four-view or flipbook images, execute runs Python, HScript or expressions, and docs returns the Houdini documentation for the installed build offline.
- When to use it
- Useful when an assistant should work inside Houdini itself: building or adjusting node networks, inspecting geometry, running cooks and renders, or checking results visually through viewport captures. It suits iterative, autonomous 3D workflows rather than one-off questions about Houdini.
- Requirements
- Runs locally as a PyPI package (houdini-mcp-server) over stdio, with uv required for the plugin path. A SideFX Houdini installation is needed; the server can start a headless hython session if none is open, and ffmpeg is used for flipbook encoding. Communication is over localhost only. No accounts, API keys or environment variables are declared, though HOUDINIMCP_PORT and HOUDINI_USER_PREF_DIR are mentioned for port and preferences configuration.
Installation
In SourceWeft
- Open Houdini MCP in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Houdini MCP
[An illustration titled "Houdini MCP", showing three agent platforms linked to the NodebookMD icon][PyPI Version] [License: MIT] [Python 3.10+] [MCP Compatible] [Houdini 22.0]
Connect SideFX Houdini to Claude, Codex, Gemini, Cursor, opencode or pi.
This MCP provides Full Markdown Documentation and Viewport Screenshots support to your agents of choice, enabling strong feedback loops and autonomous workflows.
Install
Windows
macOS / Linux
uv
The installer adds the plugin to Houdini and the server to your AI clients of choice. Restart both.
pi also needs pi install npm:pi-mcp-adapter.
Claude plugin
This repository is also a Claude plugin, for Claude Code and for Cowork on your computer. It needs uv.
The plugin starts a headless Houdini without setup. To connect the Houdini that you have open, ask Claude to run the houdini-setup skill.
What the plugin runs
uv run --frozenbuilds an environment fromuv.lockin the plugin folder, then starts the MCP server from this repository.- The server talks to Houdini on
localhostonly. It startshython, orhoudinion request, from your Houdini install, andffmpegto encode a flipbook movie. docsreads the documentation out of your Houdini install with houdinimd-docs. It sends nothing over the network.houdini-setupwrites the HoudiniMCP package into your Houdini preferences folder, after you approve it.- No tool sends data to a remote service.
executeruns any Python that Claude writes in your Houdini session.
Tools
No Houdini open? The server starts a headless hython.
batch builds a whole network in one call, and it is all or nothing: a failed
step undoes the steps before it. A build that works comes back with the cooked
point and primitive counts, and the nodes with errors.
Warning:
executeruns any Python in Houdini. Save your work.
Troubleshooting
For agents and scripts
Without a terminal, the installer asks nothing and takes the defaults.
Flags: --houdini-version none skips the plugin, --prefs-dir PATH names the
prefs folder, --harness none|all|KEY (repeatable), --quiet-start stops the
first-launch dialogs. The bootstrap scripts pass every flag through.
Manual client setup: run houdinimcp-bridge with no arguments.
claude mcp add --transport stdio houdini -- houdinimcp-bridge for Claude Code.
From a clone: uv run python -m bridge.onboarding.install.
Layout: src/houdinimcp/ is the plugin, a TCP server inside Houdini on
localhost:9877. src/bridge/ is the MCP server and the installer. Messages
are JSON with a 4-byte length prefix. HOUDINIMCP_NO_HEADLESS=1 stops the
headless start. Read AGENTS.md before you change code.
Credits
Built on blender-mcp, capoomgit/houdini-mcp, eetumartola/houdini-mcp, Houdini21MCP and fxhoudinimcp. MIT licensed.
Not affiliated with SideFX. Houdini and SideFX are trademarks of SideFX Software Inc.
Source: README.md at commit 23e13cc
Tools
0Version history
1- v0.7.3LatestOct 4, 2026

