Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
pip install -r requirements.txt2
Register it in Claude Code
claude mcp add autodesk-maya -- python3 /FULL/PATH/TO/maya-mcp-server/src/expanded_mcp_server.pyReplace any placeholder paths in the command with the real path on your machine.
3
Make your agent remember this setup
autodesk-maya's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- 30+ comprehensive tools for Maya control
- Natural language interface for 3D scene building
- Supports procedural generation and complex production workflows
- No Maya installation required on the AI host (uses command port)
- Production-ready with error handling and logging
Tools 5
primitivesCreate any of the 19 types of polygon or NURBS primitive shapes.mesh_opsPerform advanced mesh modeling operations including extrude, bevel, smooth, and boolean.lightingAdd professional lighting to the scene including point, directional, spot, area, ambient, and volume lights.materialsApply materials such as Lambert, Blinn, Phong, or PBR to objects.animationSet keyframe transforms for objects in the scene.Environment Variables
MAYA_HOSTMaya hostname (default: localhost)MAYA_PORTCommand port (default: 4434)Try it
→Create a sphere at the origin.
→Create a cube, scale it to [10, 5, 10], and bevel edges with 0.2 offset.
→Build a castle with a keep, 4 towers, walls with gate cutout, and apply a stone material.
→Create a torus, bevel its edges, and add a gold metallic material.
Original README from AYDJI/Autodesk-Maya-MCP
Maya MCP Server
Control Autodesk Maya with AI through natural language
A production-ready Model Context Protocol (MCP) server that enables AI assistants like Claude to control Autodesk Maya programmatically with 30+ comprehensive tools.
Features
- 30+ Maya Tools - Comprehensive control over Maya's features
- No Maya Installation Required - Uses Maya's built-in command port
- Natural Language Interface - Build 3D scenes through conversation
- Production Ready - Error handling, logging, validation
- Fully Documented - Extensive guides and examples
What You Can Do
- Create any primitive shape (19 types)
- Advanced mesh modeling (extrude, bevel, smooth, boolean)
- Professional materials and lighting
- Scene organization and hierarchy
- Procedural generation (arrays, grids, patterns)
- Animation keyframes
- Deformers and non-destructive editing
Quick Start
Prerequisites
- Python 3.8 or higher
- Autodesk Maya 2020 or higher
- Claude Desktop (or any MCP-compatible client)
Installation (2 Minutes)
1. Install Python dependencies:
cd maya-mcp-server
pip install -r requirements.txt
2. Open Maya command port:
In Maya Script Editor (Python tab):
import maya.cmds as cmds
cmds.commandPort(name="localhost:4434", sourceType="python", echoOutput=False)
print("Maya ready for MCP!")
3. Configure Claude Desktop:
Edit config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"maya": {
"command": "python3",
"args": ["/FULL/PATH/TO/maya-mcp-server/src/expanded_mcp_server.py"],
"env": {
"MAYA_HOST": "localhost",
"MAYA_PORT": "4434"
}
}
}
}
4. Restart Claude Desktop
5. Start creating!
"Create a torus, bevel its edges, add a gold metallic material"
Documentation
| Document | Description |
|---|---|
| Quick Start | Get running in 2 minutes |
| Tools Reference | All 30+ tools documented |
| Examples | Learn by example |
| Troubleshooting | Common issues solved |
Example Usage
Simple
You: "Create a sphere"
Maya: Creates sphere at origin
Intermediate
You: "Create a cube, scale it to [10, 5, 10], bevel edges with 0.2 offset"
Maya: Creates beveled box
Advanced
You: "Build a castle with keep, 4 towers, walls with gate cutout, stone material"
Maya: Creates complete castle scene
Available Tools (30+)
| Category | Tools |
|---|---|
| Primitives | 19 types (polygon + NURBS) |
| Mesh Ops | Extrude, Bevel, Smooth, Boolean, Combine, Separate |
| Lighting | Point, Directional, Spot, Area, Ambient, Volume |
| Materials | Lambert, Blinn, Phong, PBR |
| Organization | Group, Parent, Arrange (grid/circle), Duplicate |
| Animation | Keyframe transforms |
| Plus | Cameras, Curves, Deformers |
See Tools Reference for details.
Project Structure
maya-mcp-server/
├── src/
│ ├── expanded_mcp_server.py # Main server (30+ tools)
│ ├── simplified_mcp_server.py # Basic version (6 tools)
│ └── maya_setup.py # Quick Maya setup
├── docs/
│ ├── QUICK_START.md # Setup guide
│ ├── TOOLS_REFERENCE.md # Tool docs
│ ├── EXAMPLES.md # Tutorials
│ └── TROUBLESHOOTING.md # Help
├── examples/
│ └── example_prompts.md # Sample prompts
├── tests/
│ └── test_connection.py # Connection test
├── README.md # This file
├── requirements.txt # Dependencies
├── setup.py # Installer
└── LICENSE # MIT License
Testing
Test Maya connection:
python tests/test_connection.py
Configuration
Environment variables:
MAYA_HOST- Maya hostname (default: localhost)MAYA_PORT- Command port (default: 4434)
Tips
- Use descriptive names:
tree_trunknotcube1 - Combine operations: Do multiple things in one prompt
- Build hierarchies: Use grouping and parenting
- Leverage strengths: NURBS for organic, polygons for hard surface
Troubleshooting
"Could not connect to Maya"
- Verify Maya is running
- Check:
cmds.commandPort("localhost:4434", query=True)
License
MIT License - Free to use and modify
Acknowledgments
- Anthropic - Model Context Protocol
- Auto