3ds Max Plugin
Install Hydrilla for 3ds Max once and Claude, Cursor, Codex and other MCP apps can read and edit the open 3ds Max scene through 178 hydrilla_max_* tools. It also generates models and imports them.
Install
Windows, 3ds Max 2023 to 2027. No admin rights or separate Python needed.
- Download hydrilla-3dsmax.mzp from https://hydrilla.ai/integrations/3dsmax.
- In 3ds Max, choose Scripting › Run Script…, pick the file and click Open (or drag it onto the viewport). Do not use Install Max Creation Graph (.mcg) Package….
- Click Yes when Hydrilla asks to install. It confirms when it is done.
- Restart 3ds Max once.
If the file is not listed in the Run Script dialog, set the file type to All files. After the restart, the connection AI apps use starts by itself every time 3ds Max opens.
Hydrilla menu
3ds Max gets a Hydrilla menu. When the menu bar is full, it is under the » arrow at the right end.
Generate and import…: Opens the window that generates models from a prompt or picture and runs the Bridge.AI connection status: Says whether AI apps can reach this 3ds Max.Connect an AI app…: Opens the MCP setup steps.Use this 3ds Max for AI: Sends AI requests to this window when several are open.Check for updates: Looks for a newer version now. Hydrilla also checks once a day when 3ds Max starts.Uninstall Hydrilla…: Removes Hydrilla for 3ds Max.
Connect an AI app
Add the Hydrilla MCP server to your AI app on the same Windows computer. It is the same hydrilla entry used for generating models; if you already have it, restart the AI app. The 3ds Max tools appear once Hydrilla for 3ds Max is installed. Then, with 3ds Max open, ask:
If it lists the objects in your scene, you are set. Start requests with “Use Hydrilla” so the agent picks these tools when other 3D tools are installed. Every change is one undo step.
Hydrilla Agent, the agent inside the Hydrilla app, works in Blender only for now. In 3ds Max, use your own AI app through the MCP server.
Tools
178 tools, all named hydrilla_max_…, in these groups: Connection and session, Scripting, Scene state and edits, Inspection, Objects and organization, Modeling and modifiers, Materials and textures, Lighting, Controllers, animation and wiring, Viewport, Render, Effects and state sets, .max files, Autodesk Cosmos assets, Data Channel, Max Creation Graph, tyFlow, RailClone, Forest Pack, Pulze Scene Manager. Plugin tools (tyFlow, RailClone, Forest Pack, Pulze, Data Channel, Max Creation Graph) work when that plugin is installed in 3ds Max. The full list is on hydrilla.ai/integrations/3dsmax, and the agent guide is the MCP resource hydrilla://3dsmax/guide.
For clients with a tool limit or a small context, set HYDRILLA_MAX_TOOLS to progressive. The agent then sees only hydrilla_max_list_toolsets, hydrilla_max_describe_toolset and hydrilla_max_call_tool. off hides them.
{
"mcpServers": {
"hydrilla": {
"command": "npx",
"args": ["-y", "hydrilla-mcp@latest"],
"env": {
"HYDRILLA_API_KEY": "hyd_live_your_api_key_here",
"HYDRILLA_MAX_TOOLS": "progressive"
}
}
}
}How it works
- The
.mzpinstalls an application package in%APPDATA%\Autodesk\ApplicationPlugins\Hydrilla3dsMax(a C++ plugin and MAXScript listener inside 3ds Max, plus the Hydrilla menu) and the engine with its own Python in%LOCALAPPDATA%\Hydrilla\3dsmax, described byinstall.jsonthere. - The MCP server sees
install.jsonand registers thehydrilla_max_*tools. - On the first call it starts the engine and forwards calls to it; the engine talks to 3ds Max over a local named pipe. If the engine exits, the next call starts it again.
The engine is the open-source 3dsmax-mcp project (MIT).
Safety
- Everything runs on your computer. The scene is not uploaded, and only apps on this computer can reach it.
- Every change can be undone with Ctrl+Z.
- Safe mode, on by default, blocks script commands that run programs or delete files. It is set in
%LOCALAPPDATA%\3dsmax-mcp\mcp_config.ini; restart 3ds Max after changing it. - Opening, resetting or closing a file never throws away unsaved work without asking.
Generate and import
Hydrilla › Generate and import… opens the Hydrilla window. Paste your API key under Account (it shows Connected and your credits), then click Generate from text or Generate from image. The model is imported into the scene. Click Run Bridge (it changes to Bridge ON) to receive models from Studio or from send_to: "3dsmax" on port 7347.
glTF import
If this 3ds Max cannot import glTF directly, the GLB is saved and the window shows where. Import it with a glTF importer, or convert it to FBX.
Troubleshooting
- No hydrilla_max tools: restart the AI app; the tools are only offered on Windows with Hydrilla for 3ds Max installed.
- The AI says 3ds Max is not connected: check Hydrilla › AI connection status, and restart 3ds Max once after installing.
- Several 3ds Max windows: choose Hydrilla › Use this 3ds Max for AI in the one to use.
- A file is in use during install: close every 3ds Max and any AI app using Hydrilla, open one 3ds Max and run the installer again.
- 3dsmax-mcp is already installed: the separate open-source plugin uses the same connection. Remove it while 3ds Max is closed, then install again.
- Remove it: Hydrilla › Uninstall Hydrilla…, then restart 3ds Max.
MCP Server
Connect Claude Code, Cursor or Codex.
Blender Add-on
Generate in Blender and let your agent build the scene.