Maya MCP

Model Context Protocol (MCP) server implementation for Autodesk Maya

Tested with Maya 2023, 2025.

v0.2.0

This project enables AI assistant clients like Claude Desktop to control Autodesk Maya through natural language using the Model Context Protocol (MCP).

This is early days for Maya MCP server and has a minimal set of functionality. It's really the architecture design and simplicity that has been the initial focus.

Here is a list of some of the tools registered with Maya MCP.

Basic Tools

| Tool | Description | |------|-------------| | list_objects_by_type | Get a list of objects in the scene. Use filter_by to filter for certain objects such as "cameras", "lights", "materials", or "shapes". | | create_object | Create an object in the Maya scene. Object types available are cube, cone, sphere, cylinder, camera, spotLight, pointLight, directionalLight. | | get_object_attributes | Get a list of attributes on a Maya object. | | set_object_attributes | Set an object's attribute with a specific value. | | scene_new | Create a new scene in Maya. Use the force argument to force a new scene when an existing scene is loaded and has been modified. | | scene_open | Load in a scene into Maya. | | scene_save | Save the current scene. If the filename is not specified, it will save it as its current name. | | select_object | Select an object in the scene. |

Advanced Modeling Tools

| Tool | Description | |------|-------------| | create_advanced_model | Create complex 3D models like cars, trees, buildings, cups, and chairs with detailed parameters. | | mesh_operations | Perform modeling operations such as extrude, bevel, subdivide, boolean, combine, bridge, and split. | | create_material | Create and assign materials with various types (lambert, phong, wood, marble, chrome, glass, etc.) | | create_curve | Generate NURBS curves for various shapes (line, circle, spiral, helix, star, gear, etc.) | | curve_modeling | Create geometry using curve-based modeling techniques (extrude, loft, revolve, sweep, etc.) | | organize_objects | Organize objects through grouping, parenting, layout, alignment, and distribution. | | generate_scene | Generate complete 3D scenes with multiple objects (city, forest, living room, office, park) |

Installation

Maya MCP server is designed so there is only an MCP server and doesn't require anything to be installed within Maya. This is helpful since you can easily use different versions of Maya and not have to worry about coordinating version changes. This is done by taking advantage of the default Command Port Maya opens up for MEL scripting.

MCP requires Python 3.10 or greater. Currently using pip as the package requirements are minimal. To install the virtual environment:

1. download this project
2. Create a virtual env using Python 3.10+ in the project directory. python -m venv .venv
3. activate the virtual environment
   • Windows: .venv\Scripts\activate.bat
   • Mac/Linux: source .venv\bin\activate.sh
4. pip install -r requirements.txt

As stated, there is nothing to install for Maya.

MCP Client Configuration

Depending on which MCP Client you're using, the configuration file location differs. For Anthopic Claude Desktop, go to File -> Settings -> Developer Tab and press the Edit Config button. This will bring up the file finder in the directory location of the JSON config file.

Next you need to edit the config JSON file by hand using a text editor. Make sure to use full file paths.

{
  "mcpServers": {
    "MayaMCP": {
      "command": "[FULL PATH TO MayaMCP PROJECT]/.venv/Scripts/python.exe",
      "args": [
        "[FULL PATH TO MayaMCP PROJECT]/src/maya_mcp_server.py"
      ]
    }
  }
}

Once the changes have been made, restart Claude Desktop (use Exit menu item instead of just closing the window). In th

... View full README on GitHub