Maya MCP server

Maya MCP Server for Autodesk Maya

<!-- mcp-name: io.github.GimbalGoats/maya-mcp -->

Maya MCP is an open-source, local Model Context Protocol server for controlling Autodesk Maya through Maya's commandPort.

Supported Maya versions: Autodesk Maya 2024 and later.

It gives MCP clients a typed tool surface for scene work, nodes, selection, modeling, shading, skinning, animation, curves, scripts, and viewport capture without importing Maya modules in the server process.

This project is unofficial and is not affiliated with or endorsed by Autodesk. Autodesk Maya is a trademark of Autodesk, Inc.

Why Use It

• runs outside Maya, so the server stays isolated from Maya imports
• talks to Maya over localhost only
• exposes 71 typed tools instead of raw API calls
• supports safer scene replacement flows for unsaved changes
• leaves raw code execution disabled unless you opt in

Claude Desktop Quick Start

For Claude Desktop, use the packaged MCPB extension from the latest GitHub Release.

it into Claude Desktop, or using Settings -> Extensions -> Advanced settings -> Install Extension.

1. Download maya-mcp-.mcpb from the release Assets section.
2. Install it in Claude Desktop by double-clicking the .mcpb file, dragging

nodes_list.

1. Keep the Maya commandPort setting at 7001 unless you use a different port.
2. Open Maya and run the commandPort setup from the next section.
3. In Claude Desktop, verify with healthcheck, sceneinfo, and

Claude Desktop uses underscore tool names such as scene_info. Other MCP clients use dotted names such as scene.info.

Quick Start

1. Install

pip install maya-mcp

On Windows:

py -m pip install maya-mcp

From source:

pip install -e ".[dev]"

2. Open Maya commandPort

Download, then paste and run, the complete scripts/enable_commandport.py file in Maya's Python Script Editor. The helper keeps the established Python + echoOutput path on Maya 2025 and later. On Maya 2024 only, it selects the loopback-only response compatibility path required by that release.

3. Start the server

maya-mcp

Other supported launch styles:

python -m maya_mcp.server
python src/maya_mcp/server.py
fastmcp run

fastmcp run works from this repo because it includes fastmcp.json.

4. Add it to your client

Codex CLI / IDE extension

Codex uses ~/.codex/config.toml for MCP servers. The CLI and IDE extension share that config.

Installed package:

[mcp_servers.maya]
command = "maya-mcp"

Source checkout or Windows-friendly setup:

[mcp_servers.maya]
command = "py"
args = ["-m", "maya_mcp.server"]
env = { PYTHONPATH = "src" }

Shortened. The full README is on GitHub.