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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-quality-maintenanceEnables AI assistants to connect to and control Autodesk Maya for 3D modeling, animation, and rendering operations through the Model Context Protocol, supporting object creation, transformation, scene queries, and Python command execution.Last updated
- Flicense-qualityDmaintenanceEnables AI assistants to programmatically control Autodesk Maya via natural language using over 30 tools for 3D modeling, lighting, and animation. It connects through Maya's command port to facilitate procedural scene generation and complex production-ready workflows.Last updated1
- Alicense-qualityCmaintenanceEnables AI assistants like Claude Desktop to control Autodesk Maya via natural language through the Model Context Protocol.Last updatedMIT
- Alicense-qualityFmaintenanceEnables AI-powered 3D content creation in Blender through natural language, including text-to-3D, image-to-3D, animation, rigging, rendering, and export.Last updated1MIT
Related MCP Connectors
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Generate, edit, and deploy immersive 3D/WebGL web projects from any MCP assistant.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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