Houdini MCP
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
powershell -c "irm https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.bat -OutFile bootstrap.bat; .\bootstrap.bat"
macOS / Linux
curl -sSL https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.sh | bash
uv
uv tool install houdini-mcp-server && houdinimcp-install
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.
Tools
| Read | scene_overview node_inspect geometry_inspect stage_inspect select console |
| Edit | node_edit parm_set connect hda batch |
| Run | cook render pdg playbar scene_file |
| See | capture: the viewport, a camera, four views or a flipbook |
| Code | execute: Python, HScript, expressions, VEX check |
| Docs | docs: the Houdini documentation of your build, offline, from houdinimd-docs |
| Session | session: status; starts Houdini headless or with its window |
No Houdini open? The server starts a headless hython.
Warning:
executeruns any Python in Houdini. Save your work.
Troubleshooting
| Problem | Fix |
|---|---|
| No Houdini listens for the bridge | Start Houdini, or click Toggle MCP Server on the HoudiniMCP shelf. |
| No HoudiniMCP shelf | Restart Houdini. houdinimcp-install --list shows where the plugin went. |
| Houdini started from Git Bash has no plugin | Git Bash sets HOME. Set the user variable HOUDINI_USER_PREF_DIR to %USERPROFILE%\Documents\houdini__HVER__. |
capture says there is no viewport |
The session is headless. Call session with action="start_gui". |
| You must have a fixed port | Set HOUDINIMCP_PORT for Houdini and for the bridge. Without it, the plugin takes a free port from the operating system and tells the bridge which one. |
For agents and scripts
Without a terminal, the installer asks nothing and takes the defaults.
houdinimcp-install --list # Houdini installs and clients found, as JSON
houdinimcp-install --yes --json # newest Houdini, every client found; JSON report
houdinimcp-install --houdini-version 22.0 --harness claude-code --yes
houdinimcp-install --dry-run --yes # change nothing
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.
1 maintainer
Metadata
1 maintainer
Release files for houdini-mcp-server 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| houdini_mcp_server-0.5.0.tar.gz | 137.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| houdini_mcp_server-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 305.0 kB
Release files / houdini_mcp_server-0.5.0.tar.gz
| Download URL | houdini_mcp_server-0.5.0.tar.gz |
|---|---|
| Size | 137.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c12a31ea19f8524f32dd2c823d993ce1e3795ff5e8acd565269015a7981c3b78
|
|
BLAKE2b-256 checksum How to use checksums |
91dfb8cf093f8622f197e925a8afd0af72e141807be56c259b8d8eec3166dbaa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / houdini_mcp_server-0.5.0-py3-none-any.whl
| Download URL | houdini_mcp_server-0.5.0-py3-none-any.whl |
|---|---|
| Size | 167.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6eb22fc32dfa224f3828d9c1e219e1e78edf61913521bdd1f3beacf3d5248586
|
|
BLAKE2b-256 checksum How to use checksums |
a1a1d5126d83a87604a73ecab52a85e8be1654f42ed6a3a1eaf9d2dfa587010f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for houdini-mcp-server 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
