Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/δΈ­ζ–‡
Sign inSign up
Home/Servers/Houdini MCP

Houdini MCP

I
by io.github.JTCHE

Connect agents to SideFX Houdini: edit the scene, cook, render, see the viewport, read the docs.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command
uvx houdini-mcp-server==0.7.7
Provider
Claude Code
claude mcp add io.github.jtche-houdini-mcp -- uvx houdini-mcp-server==0.7.7

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.jtche-houdini-mcp": {
      "command": "uvx",
      "args": [
        "houdini-mcp-server==0.7.7"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • FirecrawlπŸ”₯ Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • reaReverse engineer anything with agents, from app behavior down to native binaries.
  • rea-changelog-updatePrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

Connect agents to SideFX Houdini: edit the scene, cook, render, see the viewport, read the docs.

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.

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.

  • uv run --frozen builds an environment from uv.lock in the plugin folder, then starts the MCP server from this repository.
  • The server talks to Houdini on localhost only. It starts hython, or houdini on request, from your Houdini install, and ffmpeg to encode a flipbook movie.
  • docs reads the documentation out of your Houdini install with houdinimd-docs. It sends nothing over the network.
  • houdini-setup writes the HoudiniMCP package into your Houdini preferences folder, after you approve it.
  • No tool sends data to a remote service. execute runs any Python that Claude writes in your Houdini session.

Tools

Readscene_overview node_inspect geometry_inspect stage_inspect select console
Editnode_edit parm_set connect hda batch
Runcook render pdg playbar scene_file
Seecapture: the viewport, a camera, four views or a flipbook
Codeexecute: Python, HScript, expressions, VEX check
Docsdocs: the Houdini documentation of your build, offline, from houdinimd-docs
Sessionsession: status; starts Houdini headless or with its window

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: execute runs any Python in Houdini. Save your work.

ProblemFix
No Houdini listens for the bridgeStart Houdini, or click Toggle MCP Server on the HoudiniMCP shelf.
No HoudiniMCP shelfRestart Houdini. houdinimcp-install --list shows where the plugin went.
Houdini started from Git Bash has no pluginGit Bash sets HOME. Set the user variable HOUDINI_USER_PREF_DIR to %USERPROFILE%\Documents\houdini__HVER__.
capture says there is no viewportThe session is headless. Call session with action="start_gui".
You must have a fixed portSet 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.

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
houdinimcp-install --uninstall     # remove the plugin and every client entry

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.

How do I install Houdini MCP?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Houdini MCP need an API key?
No required environment variable is listed on this record.
What transport does Houdini MCP use?
Houdini MCP runs locally over stdio.
When was Houdini MCP last checked?
Last checked 2026-10-16. Connect agents to SideFX Houdini: edit the scene, cook, render, see the viewport, read the docs.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA