Maya MCP Server
Allows control of Autodesk Maya through natural language, enabling AI-assisted 3D modeling, scene manipulation, material editing, animation, and workflow automation.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Maya MCP ServerCreate a blue sphere at position (0, 2, 0)"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Maya MCP Server
Connect Claude AI to Autodesk Maya through Model Context Protocol
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Français | Deutsch | Русский
Overview
Maya MCP Server enables Claude AI to directly control Autodesk Maya through the Model Context Protocol, enabling:
🎨 AI-assisted 3D modeling
🤖 Natural language Maya control
📸 Real-time scene preview
🔧 Workflow automation
Related MCP server: Maya MCP Server
Quick Start
1. Install Dependencies
pip install "mcp[cli]>=1.3.0"2. Load Maya Plugin
Load plug-ins/maya_mcp.py in Maya's Plug-in Manager:
Copy
plug-ins/maya_mcp.pyto:Windows:
C:\Users\<username>\Documents\maya\<version>\plug-ins\macOS:
~/maya/<version>/plug-ins/
Open Maya → Windows > Settings/Preferences > Plug-in Manager
Find
maya_mcp.py, check Loaded and Auto loadVerify in Script Editor:
MayaMCP: Plugin loaded successfully MayaMCP: Server started at localhost:9877
3. Configure Claude Desktop
Edit config file (Settings > Developer > Edit Config):
Option A: Using npx (Recommended)
Standard Configuration:
{
"mcpServers": {
"maya-mcp": {
"command": "npx",
"args": [
"--yes",
"maya-mcp-server"
],
"env": {
"MAYA_HOST": "localhost",
"MAYA_PORT": "9877"
},
"alwaysAllow": [
"get_scene_info",
"get_object_info",
"create_primitive",
"delete_object",
"set_material",
"transform_object",
"smart_select",
"get_scene_summary",
"get_console_output",
"execute_maya_code"
]
}
}
}Force Update Configuration (always pull latest package):
{
"mcpServers": {
"maya-mcp": {
"command": "npx",
"args": [
"--yes",
"--no-cache",
"maya-mcp-server"
],
"env": {
"MAYA_HOST": "localhost",
"MAYA_PORT": "9877"
},
"alwaysAllow": [
"get_scene_info",
"get_object_info",
"create_primitive",
"delete_object",
"set_material",
"transform_object",
"smart_select",
"get_scene_summary",
"get_console_output",
"execute_maya_code"
]
}
}
}Option B: Using Python
{
"mcpServers": {
"maya-mcp": {
"command": "python",
"args": ["-m", "maya_mcp.server"],
"env": {
"PYTHONPATH": "YOUR_PROJECT_PATH/src",
"MAYA_HOST": "localhost",
"MAYA_PORT": "9877"
},
"alwaysAllow": [
"get_scene_info",
"create_primitive",
"delete_object",
"set_material",
"transform_object",
"smart_select",
"get_scene_summary",
"get_console_output",
"execute_maya_code"
]
}
}
}💡 More configuration options in
examples/
4. Test Connection
Restart Claude Desktop, then ask:
Get current Maya scene informationIf you see scene info returned, it's working! ✅
Features
🛠️ Core Tools
Tool | Function |
| Get scene information (objects, cameras, lights) |
| Get object details (position, rotation, material) |
| Create geometry (cube/sphere/cylinder/plane/torus) |
| Delete objects |
| Transform objects (move/rotate/scale) |
| Set materials and colors |
| Execute Python code |
| Smart object selection with regex and filters |
| Get comprehensive scene summary |
| Get Maya console/script editor output 🆕 |
💬 Example Conversations
User: Create a red cube at position (0, 5, 0)
Claude:
1. Created cube
2. Moved to specified position
3. Applied red material
✅ DoneUser: Create a simple table and chair scene
Claude:
1. Created table top (scaled cube)
2. Created 4 table legs (cylinders)
3. Created chair
4. Set materials
✅ Scene created successfullyUsage Examples
Basic Operations
# Scene queries
"Show all objects in the current scene"
"Get detailed info for pCube1"
"Get console output to see recent Maya logs"
# Create objects
"Create a sphere named mySphere"
"Create 10 cubes in a row"
# Modify objects
"Move pCube1 to (5, 0, 0)"
"Set pSphere1 to blue"
"Rotate pCylinder1 45 degrees on Y axis"
# Smart selection
"Select all objects with 'character' in their name"
"Find all meshes with more than 5000 faces"Advanced Operations
# Procedural modeling
"Execute code to create a 5x5 cube grid"
# Vertex/Face editing
"Create a plane and edit vertices to make a terrain"
"Extrude faces to create details"
# UV editing
"Apply automatic UV projection to selected objects"
"Create spherical UV mapping for the sphere"
# Animation
"Create keyframe animation for bouncing ball"
"Set up 3-point lighting system"
# Rigging
"Create a spine bone chain with 5 joints"
"Set up parent constraints"
# Dynamics
"Create particle system with gravity"
"Apply bend deformer to plane"
# Boolean operations
"Subtract cube2 from cube1"
"Union two overlapping spheres"
# Batch operations
"Set all spheres to random colors"
# Complex scenes
"Create a simple interior scene with floor, walls, and furniture"Configuration Options
Environment Variables
Variable | Default | Description |
|
| Maya server address |
|
| Maya server port |
| - | Python module search path (Python direct mode only) |
Custom Port
In Maya plugin:
start_maya_mcp_server(host='localhost', port=9878)In config file:
"env": {
"MAYA_PORT": "9878"
}Troubleshooting
Connection Failed
Issue: "Cannot connect to Maya"
Solutions:
✅ Verify Maya is running
✅ Confirm plugin is loaded (check Plug-in Manager)
✅ Check Script Editor for startup messages
✅ Ensure port 9877 is not in use
Module Not Found
Issue: "ModuleNotFoundError: No module named 'maya_mcp'"
Solutions:
Install dependencies:
pip install "mcp[cli]>=1.3.0"Check PYTHONPATH setting (if using Python direct mode)
Try using npx method instead
NPX Configuration Issues
Issue: npx fails to start the server or can't find files
Solutions:
Use absolute paths in configuration (not relative paths)
Use forward slashes
/in Windows pathsVerify project structure is intact
See detailed guide: NPX_TROUBLESHOOTING.md
Plugin Load Failed
Issue: Maya reports "No initializePlugin() function"
Solutions:
Ensure using latest version of
maya_mcp.pyPlugin file contains
initializePlugin()anduninitializePlugin()functions
Security Notes
⚠️ Important:
execute_maya_codetool allows execution of arbitrary Python codeAlways save Maya scene before executing
Use with caution in production environments
Test operations in a test scene first
Logs
Server logs are saved at:
Windows:
%TEMP%\maya-mcp\maya-mcp.logmacOS/Linux:
/tmp/maya-mcp/maya-mcp.log
Check logs to debug connection issues or command execution errors.
Development
Adding New Tools
Add command handler in
plug-ins/maya_mcp.pyAdd MCP tool definition in
src/maya_mcp/server.pyTest new tool
Run Development Server
# Set environment
export PYTHONPATH=/path/to/maya-mcp-server/src
# Run server
python -m maya_mcp.serverContributing
Contributions welcome! See CONTRIBUTING.md
Acknowledgments
Inspired by:
Blender-MCP - Architecture reference
License
Disclaimer
This is a third-party project, not an official Autodesk product.
Get Started • Configuration Guide • Report Issues
Made with ❤️ for Maya artists and AI enthusiasts
This server cannot be installed
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jeffreytsai1004/maya-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server