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

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+)

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

1. Use descriptive names: tree_trunk not cube1

2. Combine operations: Do multiple things in one prompt

3. Build hierarchies: Use grouping and parenting

4. 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)

See Troubleshooting Guide

License

MIT License - Free to use and modify

Acknowledgments

• Anthropic - Model Context Protocol

• Autodesk - Maya Python API

• PatrickPalmer - MayaMCP inspiration

Get Started

1. Read Quick Start Guide

2. Try Example Prompts

3. Build something amazing!

Ready to build 3D worlds with AI?