maya

This Maya MCP Server enables Claude AI to directly control Autodesk Maya via the Model Context Protocol. It exposes a set of core Maya operations as MCP commands, including querying scene data, creating primitives, transforming objects, applying materials, and executing Python code within Maya. The included tools allow for AI-assisted modeling, natural language-driven Maya control, real-time scene previews, and workflow automation. To use it, run the server via the Python module (maya_mcp.server) and connect Claude Desktop to the configured host and port (default localhost:9877). The server exposes commands such as get_scene_info, get_object_info, create_primitive, delete_object, transform_object, set_material, execute_maya_code, smart_select, get_scene_summary, and get_console_output for interactive operations with Maya.

Prerequisites:

• Python 3.10+ installed on your system
• Autodesk Maya installed and running if you want to interact with a live scene
• Internet access to install Python packages

1. Install the MCP CLI and dependencies

pip install "mcp[cli]>=1.3.0"

2. Ensure Maya is prepared for MCP (optional but recommended by guide):

• Copy plug-ins/maya_mcp.py into your Maya plug-ins directory
• Enable the plugin in Maya's Plug-in Manager and verify startup messages

3. Install/Run the Maya MCP server module Option A (Python direct mode):

# Run the server (from project root or ensure maya_mcp is importable)
python -m maya_mcp.server

Option B (if you plan to run via CLI wrapper or integration):

pip install -e .  # if you are developing the package locally
maya-mcp-server  # via provided entrypoint if installed

4. Start Claude Desktop and configure the MCP server

• Create a server entry with command: python
• Args: [-m, maya_mcp.server]
• Environment variables: MAYA_HOST=localhost, MAYA_PORT=9877
• Save configuration and reload Claude Desktop

5. Verify connection

• Restart Claude Desktop
• Issue: "Get current Maya scene information" or check Maya logs for the server startup message

Note: If you prefer NPX or a different launcher, you can adapt the configuration to use npx or Python direct mode as shown in the README.

Tips and notes:

• The Maya MCP server exposes a suite of tools for Maya control. The execute_maya_code tool can run arbitrary Python, so use with caution and save your scene before running code.
• Environment variables MAYA_HOST and MAYA_PORT configure the target Maya instance; adjust if Maya runs remotely or on a non-default port.
• If Maya is not responding, check the Maya Script Editor and the plug-in manager to ensure the maya_mcp.py plug-in loaded successfully, and verify that the port (default 9877) is not in use by another process.
• If using Python direct mode, set PYTHONPATH to include your Maya MCP source path if the module layout requires it.
• For configuration, maintain explicit absolute paths in environment or config to avoid path resolution issues, especially on Windows.
• When using execute_maya_code, consider running in a sandbox or test scene to prevent unintended changes to production data.