Skip to main content
Glama

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.

Version Python Maya License


✨ 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

  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? 🎨✨

-
security - not tested
F
license - not found
-
quality - not tested

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/AYDJI/Autodesk-Maya-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server