home / mcp / maya mcp server

maya MCP Server

Provides a Python-based MCP server for Maya, enabling AI assistants to control active Maya sessions and perform scene operations.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bdeda-maya_mcp": {
      "command": "mayapy",
      "args": [
        "-m",
        "maya_mcp"
      ]
    }
  }
}

This FastMCP-based server connects Autodesk Maya to a modern MCP client, enabling AI assistants and other MCP tools to interact with an active Maya session. You can control scene objects, query selections, and perform common 3D operations through a structured MCP interface.

How to use

You can run the Maya MCP server from Maya, from a mayapy process, or as a standalone script. Use an MCP client to connect, issue tools, and retrieve scene information such as the current selection or status. If Maya is not available, some tools will be unavailable, but the server will still start.

How to install

Prerequisites you need before installing the Maya MCP server:

Python 3.10 or newer (3.11+ recommended)
Autodesk Maya must be installed to run the server with Maya
FastMCP package version 2.0.0 or newer

Install the package in development mode to enable live edits while you work.

# Using pip
pip install -e .

# Using uv
uv pip install -e .

Additional notes

You can start the server in different environments depending on your workflow. The project includes a standalone entry point and Mayapy-based start options. If Maya is unavailable, the server will warn you, but tools may be limited.

Available tools

get_server_status

Query the MCP server to retrieve its current operational status.

get_selection

Return the currently selected objects in the Maya scene.

select_objects

Select objects by their names to focus or manipulate them in Maya.

clear_selection

Clear the currently active selection in the Maya scene.