mcp-for-maya
Give AI agents a view of an Autodesk Maya scene, with checkpoints and rollback
- Platforms
- Windows, macOS, Linux
- Runs
- Locally
- Version
- 0.8.0
- Listing updated
- 4 days ago
Similar MCP servers
About mcp-for-maya
mcp-for-maya is an MCP server for design and media. It runs locally on your machine and is started by your AI client.
Instead of letting an agent write Maya Python blind, mcp-for-maya has it inspect the scene first. A snapshot returns objects, types, world positions and bounding-box sizes, and the README is candid that these are axis-aligned boxes, so overlapping boxes can belong to shapes that do not actually touch.
Every edit follows a four-step loop the project calls ICEV: inspect, compute, execute, verify. Code runs inside Maya through execute_code, then scene_assert and scene_review check the result. Checkpoints write the scene to a .ma file so a rollback can reopen it.
It connects to Maya over a command port such as :7001, and each running Maya instance needs its own port. The README warns that the server runs Python inside Maya by design and points to a threat model document.
Install
Run in a terminal
claude mcp add mcp-for-maya -- uvx mcp-for-mayaAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-for-maya": {
"command": "uvx",
"args": [
"mcp-for-maya"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-for-maya": {
"command": "uvx",
"args": [
"mcp-for-maya"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-for-maya": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-for-maya"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-for-maya": {
"command": "uvx",
"args": [
"mcp-for-maya"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-for-maya": {
"command": "uvx",
"args": [
"mcp-for-maya"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- maya_setup_guide
- Guide and diagnose the connection to Maya
- scene_snapshot
- Capture spatial data of the scene
- scene_inspect
- Inspect scene objects
- scene_measure
- Measure objects in world space
- scene_aesthetics
- Score look quality on five dimensions
- camera_create
- Create a camera from a built-in shot type
- camera_orbit
- Create an orbit animation
- scene_checkpoint
- Save the scene to a checkpoint file
- scene_rollback
- Reopen a checkpoint
- scene_checkpoint_list
- List checkpoints
- scene_plan
- Scene health checks and layout planning
- execute_code
- Run Maya Python code
- scene_assert
- Check the outcome against rules
- scene_review
- Review the result
- list_sessions
- List connected Maya sessions
- add_session
- Add a Maya session by host and port
What it does
- Scene snapshots
- Capture objects, types, world positions and bounding-box sizes in one call.
- Measurement tools
- Measure objects against each other, including overlap and bounding-box extents.
- Checkpoint and rollback
- Save the scene to a .ma file and reopen it to undo changes.
- Aesthetic review
- Score colour balance, composition, proportion, lighting and visual flow.
- Camera tools
- Create cameras from built-in shot types and orbit them.
- Multiple Maya sessions
- Auto-scan local ports or add a session by host and port.
Good for
- Let an agent lay out a display shelf in an existing scene
- Check object spacing and overlap after an AI edit
- Roll back a scene after a bad automated change
- Review lighting and composition of a scene
- Work with several Maya instances from one agent
Pricing
Pricing unknown
Prices not published
mcp-for-maya FAQ
How do I install it?
Run `pip install mcp-for-maya` or use `uvx mcp-for-maya`, per the README.
How does it connect to Maya?
Through a Maya command port, opened manually in the Script Editor or via a userSetup.py file.
Is it safe to run?
The README warns it runs Python code directly inside Maya by design and links a threat model.
Can it handle two Maya windows?
Yes, as long as each instance uses its own command port.
Is it stable?
The registry entry labels it Beta.
How do I add mcp-for-maya to Claude Code?
Run this command in your terminal: claude mcp add mcp-for-maya -- uvx mcp-for-maya
What are the best alternatives to mcp-for-maya?
The closest alternatives to mcp-for-maya are mcp-for-blender, AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more, DCC-MCP Core and Ableton MCP Server.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

