# Maya MCP

A local MCP server that drives an Autodesk Maya scene over commandPort, handing the agent 71 typed tools for modeling, animation, shading and viewport capture.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 27
- Author: GimbalGoats
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/GimbalGoats/GG_MayaMCP
- Updated: 2026-08-14
- HTML: https://affpapa.org/en/nevibecode/mcp/maya-mcp

## What it does

The server runs in its own process and reaches Maya on `localhost` instead of importing Maya modules into itself. Clients get 71 tools covering scenes, nodes, attributes, selection, connections, meshes, modeling, shading, skin, animation, curves, scripts and viewport grabs. If the server dies, the editor keeps running.

Setup is short. `pip install maya-mcp` pulls the package, `maya-mcp` starts the server. Inside Maya you run `scripts/enable_commandport.py` once from the Python Script Editor; on 2025 and later it keeps the `echoOutput` route, on 2024 it falls back to the loopback-only path. You need Python 3.10.1+ and Maya 2024 or newer.

Raw code execution is off until `MAYA_MCP_ENABLE_RAW_EXECUTION=true` is set, which is what unlocks `script.run`. `scene.new` and `scene.open` refuse while the open scene has unsaved changes unless you pass `force=True`, or a client with form elicitation can prompt for the discard. With `commandPort` closed the server will start and see nothing. Check the link with `health.check`, then `scene.info`, then `nodes.list`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add maya-mcp -- uvx maya-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from maya-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add maya-mcp -- uvx maya-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from maya-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "maya-mcp": {
            "command": "uvx",
            "args": [
                "maya-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from maya-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "maya-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "maya-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from maya-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add maya-mcp uvx maya-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from maya-mcp <command>

## When to use it
- read the open Maya scene from the chat
- block out a node graph without switching windows
- reassign shading on the current selection
- grab the viewport as an image
- bind skin weights to a mesh from a joint list

## Example prompts
- Run `health.check` and then `scene.info` — is the Maya link alive?
- List the scene with `nodes.list` and select every camera.
- Give the selected objects a new shader and capture the viewport.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md