# mcp-for-maya

> mcp-for-maya is an MCP server for design and media. Give AI agents a view of an Autodesk Maya scene, with checkpoints and rollback. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** Windows, macOS, Linux, CLI
- **Repository:** https://github.com/xxx91n/mcp-for-maya
- **MCP Registry name:** io.github.Xxx91n/mcp-for-maya
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-for-maya -- uvx mcp-for-maya
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-for-maya": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-for-maya": {
      "command": "uvx",
      "args": [
        "mcp-for-maya"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more](https://ai-powered.com/mcp/aec-pilot-mcp-for-revit-autocad-civil-3d-navisworks-and-more): AEC Pilot: MCP for Revit, AutoCAD, Civil 3D, Navisworks and more is a paid MCP server for design and media.
- [DCC-MCP Core](https://ai-powered.com/mcp/dcc-mcp-core): DCC-MCP Core is an open-source MCP server for design and media.
- [Ableton MCP Server](https://ai-powered.com/mcp/ableton-mcp-server): Ableton MCP Server is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/mcp-for-maya
