← Back to directory
H

Houdini MCP Server

Community
Connect SideFX Houdini to Claude via the Model Context Protocol.
GitHub source repository ↗
★ 282 Stars Category · Dev Tools Popular Source revision de4fd93acc20
28FMRS · D
Reliability
4/20
Security and permissions
2/20
Maintenance
6/20
Documentation
8/20
Setup experience
8/20

This project is based on blender-mcp, providing local control of Houdini from Claude. It is feature-rich but requires manual setup and is not an official product. The documentation is clear, but users should be cautious about permissions and risks.

Read the FMRS scoring method →

HoudiniMCP is an MCP server that allows you to control SideFX Houdini from Claude. It consists of two parts: a Houdini plugin (Python package) that listens on a local port (default localhost:9876) and handles commands (creating and modifying nodes, executing code, etc.), and an MCP bridge script that communicates with Claude via stdin/stdout and with Houdini via TCP. The server requires uv and Houdini, and offers optional OPUS integration for furniture and environmental procedural assets.

Tools

The tool list has not been reviewed yet.

Setup

  1. Install Houdini and uv. 2. Create a plugin folder in your Houdini scripts directory (e.g., C:/Users/YourUserName/Documents/houdini19.5/scripts/python/houdinimcp/) and place __init__.py, server.py, and pyproject.toml inside. 3. (Optional) Create a shelf tool or packages integration to auto-load the plugin. 4. In the plugin directory, add MCP using uv: cd ... && uv add "mcp[cli]". 5. Configure Claude Desktop or Cursor by adding an MCP server entry pointing to houdini_mcp_server.py. 6. If uv run succeeds but Claude fails to load MCP, ensure Claude is using the same Python version and replace "python" in the config with the path from python -c "import sys; print(sys.executable)". 7. (Optional) Set up OPUS integration by copying urls.env.example to urls.env and adding your RapidAPI key.
claude_desktop_config.json
{
  "mcpServers": {
    "houdini": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Fit and risk

Best for

  • Houdini artists and technical directors who want a seamless workflow between Claude and Houdini.
  • Users interested in AI-assisted procedural 3D modeling and scene generation.
  • Developers familiar with MCP who want to extend Claude to work with 3D tools.

Not for

  • Users without a Houdini license (requires SideFX Houdini).
  • Users seeking official support (this server is not maintained by SideFX or Anthropic).
  • Users wanting a remote server without local Houdini access (the server runs on localhost).

Required permissions

  • Local network access: listens for TCP connections on localhost:9876.
  • File system access: reads and writes files in the Houdini configuration directory.
  • Execution permission: executes Python code within the Houdini context.

Risks and side effects

  • Executing untrusted code in Houdini can lead to data loss or system damage; only use in trusted environments.
  • Running a server on localhost may expose it to other local processes; ensure no malicious software.
  • OPUS integration requires a RapidAPI key, which if mishandled could leak sensitive information.

Troubleshooting

  1. If the plugin doesn't start, check that the Houdini Python path includes the plugin directory.
  2. If Claude fails to load MCP, verify uv is in PATH and that Claude's Python version matches the uv environment.
  3. If connection fails, ensure the Houdini MCP server is running (via shelf tool or package) and port 9876 is not occupied.
  4. If OPUS tools are disabled, check if urls.env exists and contains a valid RapidAPI key.

Use cases

Control Houdini from Claude using natural language to create and modify nodes.
Execute Python code inside Houdini to automate tasks.
Leverage OPUS integration to generate furniture and environmental procedural assets.

Supported clients

Claude DesktopFull support
CursorFull support