MayaMCP

What is MayaMCP?

MayaMCP is a Model Context Protocol (MCP) server implementation that enables AI assistant clients (such as Claude Desktop) to control Autodesk Maya through natural language commands. Tested with Maya 2023 and 2025, it focuses on a clean architecture and simplicity rather than a large feature set.

How to use MayaMCP?

Install by creating a Python 3.10+ virtual environment, installing dependencies with pip install -r requirements.txt, and configuring your MCP client (e.g., Claude Desktop) with the full paths to the Python executable and src/maya_mcp_server.py. No separate installation inside Maya is required; the server communicates via Maya’s default Command Port (MEL). The first time you run it, you must click “Allow All” in Maya’s security prompt to permit ongoing communication.

Key features of MayaMCP

• Control Maya via natural language through MCP-compatible clients
• No plugin or script installation needed inside Maya
• Basic tools: list/create objects, get/set attributes, scene operations, selection
• Advanced modeling: create complex models, perform mesh operations, create materials
• Curve and scene generation tools (NURBS curves, complete 3D scenes)
• Easy to extend: add custom tools by placing a Python file in mayatools/thirdparty

Use cases of MayaMCP

• Rapidly create and manipulate 3D objects and materials using conversational prompts
• Automate repetitive scene management tasks (new scene, open, save, select)
• Generate complete 3D environments (city, forest, living room) with one command
• Prototype modeling workflows by combining mesh operations (extrude, bevel, boolean)
• Enable non‑technical users to interact with Maya through an AI assistant

FAQ from MayaMCP

What runtime does MayaMCP require?

MayaMCP requires Python 3.10 or greater and uses a standard virtual environment with pip. It has no special dependencies inside Maya.

Does MayaMCP require any installation inside Maya?

No. MayaMCP communicates with Maya through the default MEL Command Port, so you only need to install the server itself. No Maya plugin or Python module is needed.

How can I add a new tool to MayaMCP?

Add a single Python file to the mayatools/thirdparty directory. The file name and function name must match, the function must include type annotations, and any Maya‑specific imports (e.g., maya.cmds) should be inside the function body. The server automatically registers the tool at startup.

What are the current limitations?

MayaMCP is early (v0.2.0) with minimal functionality. Multi‑line Python commands cannot return results directly; each command makes two connections (one to execute, one to read results). The server has only been tested on Windows, though it should work on Linux and Mac.

How does MayaMCP handle security?

When the server first connects to Maya, a security popup asks you to “Allow All” for the ongoing command‑port communication. This permission must be granted each Maya session.