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/