mixamo-mcp

A Playwright-based automation tool for Mixamo, with both a CLI operator and an MCP server for Claude Code integration.

Features

• Browse and search animations
• Upload custom characters (FBX / OBJ / ZIP) via Auto-Rigger
• Set animation parameters (inplace, mirror, overdrive, arm-space, trim)
• Download animations with your character (FBX for Unity/Unreal, Collada)
• Persistent browser session — log in once, stays logged in
• MCP server so Claude Code can drive everything as tools

Setup

pip install -r requirements.txt
playwright install chromium

CLI usage

python main.py

Available commands:

| Command | Description | |---|---| | list [query] | List animations, optionally filtered by query | | select <id> | Select animation by ID | | set inplace true/false | Toggle in-place mode | | set mirror true/false | Toggle mirror | | set overdrive <0-100> | Set overdrive slider | | upload <path> | Upload a character file | | download <path> | Download current animation | | status | Show current screen and animation info | | quit | Exit |

MCP server (Claude Code)

The MCP server lets Claude Code control Mixamo directly as tools.

Configure

Add to your .mcp.json (already included in this repo):

{
  "mcpServers": {
    "mixamo": {
      "command": "python",
      "args": ["C:\\Users\\vital\\Projects\\mixamo-mcp\\mcp_server.py"]
    }
  }
}

Available tools

| Tool | Description | |---|---| | status() | Current screen, character, animation, params | | list_animations(query) | Search animations | | select_animation(id) | Select animation by ID | | set_param(name, value) | Set inplace / mirror / overdrive / arm-space / trim | | upload_character(path) | Upload character to Auto-Rigger | | download_animation(path, format, skin, fps) | Download animation | | confirm_review() | Confirm Auto-Rigger review step | | close_upload_modal() | Dismiss upload modal |

Download formats

| Key | Format | |---|---| | fbx_unity | FBX for Unity (default) | | fbx | FBX 2019 | | fbx_ascii | FBX 2019 ASCII | | fbx_7.4 | FBX 2014 | | fbx_6.1 | FBX 6.1 | | collada | Collada (.dae) |

Notes

• Do not run main.py and mcp_server.py at the same time — both use the same browser profile
• Log in once via the visible browser; session is saved in browser_profile/