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