Maya

You can connect an AI assistant to Autodesk Maya and control it programmatically through a complete MCP (Model Context Protocol) server. It exposes 29 Maya-capable tools, loads a plugin automatically, and supports safe, structured interactions to create, modify, inspect, and debug Maya scenes from an external agent.

How to use

Start by running the MCP server locally with NPX to enable immediate access to all 29 Maya tools. This sets up a command port and lets your AI assistant send commands to Maya through a stable MCP interface.

How to install

Prerequisites: you need Node.js for NPX and Python for manual options. Ensure you have npm and npx available, and Python 3.8+ installed if you plan to run the Python server directly.

Option A — Install and run via NPX (recommended)

# Start the MCP server with default settings
npx maya-mcp-server

# Start with custom host/port/debug options
npx maya-mcp-server --host localhost --port 8765 --debug

Option B — Manual installation and start (Python-based path)

# Clone the MCP server repository
git clone https://github.com/Jeffreytsai1004/maya-mcp.git
cd maya-mcp

# Install Python dependencies
pip install -r requirements.txt

# Start the server directly with Python
python src/server.py

Additional setup you may perform

Install the Maya plugin automatically or manually so the plugin loads when Maya starts. When using NPX you can opt into the built-in installer, or you can copy the plugin to Maya’s plug-ins folder manually if needed.

Available tools

maya_create

Create Maya objects (such as cubes and spheres) in the scene.

maya_select

Select objects by name or criteria.

maya_transform

Apply translations, rotations, and scales to objects.

maya_delete

Delete objects from the current scene.

maya_execute

Run Python commands inside Maya.

maya_get_selection

Return the currently selected objects.

maya_get_scene_info

Retrieve information about the current scene, including transforms.

maya_get_object_info

Get detailed information about a specific Maya object.

maya_list_objects

List objects in the scene matching a type or pattern.

maya_get_console_output

Fetch the Maya console output for debugging.

maya_enable_console_capture

Enable capture of the Maya console output.

maya_disable_console_capture

Disable capture of the Maya console output.

maya_clear_console_buffer

Clear the in-memory Maya console log buffer.

maya_set_debug_mode

Toggle debug mode for verbose MCP interactions.

maya_get_debug_info

Retrieve comprehensive debug information about the session.

maya_get_log_file

Get contents of Maya log files for troubleshooting.

maya_browse_outliner

Explore the Outliner hierarchy and DAG structure.

maya_get_menu_structure

Inspect Maya's main menu structure and commands.

maya_execute_menu_command

Execute a Maya menu command by name.

maya_get_shelf_tools

Query tools available on Maya shelves.

maya_list_plugins

List plugins that are loaded or available in Maya.

maya_load_plugin

Load a Maya plugin by name.

maya_unload_plugin

Unload a Maya plugin by name.

maya_api_call

Call Maya OpenMaya API functions directly.

maya_execute_mayapy

Execute a Python script via MayaPy interpreter.

maya_get_node_connections

Get detailed node connection information.

maya_search_nodes

Perform advanced searches for nodes with filters.

maya_get_workspace_info

Retrieve Maya workspace and project settings.

maya_set_workspace

Set the Maya workspace directory.