Cavi Character Animator MCP
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cavi Character Animator MCP Prepare a copy of projects/Hero, open and claim it, then export PNG and WAV."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cavi Character Animator MCP
Work on a copy you own.
MCP server for Adobe Character Animator on macOS. It prepares closed project copies, tracks which session owns an open project, reads the running application's state, imports puppets and dialogue audio, exports scenes and verifies the exported PNG and WAV files.
The server drives the application you have installed and signed in to, through a native helper. Every dispatched command is reported as unverified until the application and the output files show it. Bring your own licensed application.
Related MCP server: Osiris Premiere MCP
Install
Requires macOS, Adobe Character Animator installed and signed in, the Swift command-line compiler
(xcode-select --install; the server compiles its native helper on first use) and Python 3.15 or later with
uv. The MCP host needs Accessibility access; capture also needs Screen Recording
access. You supply your own licensed Adobe applications.
uv tool install cavi-character-animator-mcpUpgrade with uv tool upgrade cavi-character-animator-mcp. To work from a checkout instead, see
CONTRIBUTING.md.
Quickstart
Register the stdio server with your MCP client and set the workspace:
{
"mcpServers": {
"character-animator": {
"command": "cavi-character-animator-mcp",
"env": {"CAVI_ADOBE_WORKSPACE": "/absolute/path/to/workspace"}
}
}
}If your client does not inherit your shell's PATH, use the absolute path that
command -v cavi-character-animator-mcp prints. Then try a request like:
Check that Character Animator is reachable, prepare a copy of
projects/Hero, open it and claim it.
The setup guide and first result walk through the workflow. Tool paths are relative to the workspace.
What you can do
Read the application: whether it is running and reachable, its process, project root, native controls and unresolved operation state, and a capture of its window.
Copy a closed project into the workspace with its file hashes verified, open the copy and claim it with a lease before any change.
Import a puppet PSD or dialogue WAV, select a puppet, audio or scene row by name and run one fixed menu action on the selection.
Submit a PNG Sequence and WAV export of the owned scene into a new directory, then validate the exported files against an explicit recipe and write a pinned media receipt with a measured audio descriptor.
Inspect, verify, continue or reconcile a recorded native operation, and keep unknown outcomes instead of retrying them.
Tool | Purpose |
| Report whether the application is running and reachable. |
| Read the process, project root, native controls and unresolved operation state. |
| Capture the Character Animator window with text recognition into a new workspace directory. |
| Inspect, claim, renew, release or resume ownership of an open project. |
| Copy a closed |
| Open a prepared copy in the application. |
| Save an owned project as a new copy. |
| Import a puppet PSD or a dialogue WAV. |
| Run one menu action on the selection: add to a new scene, create a take from scene audio, compute lip sync or export PNG and WAV. |
| Submit a PNG Sequence and WAV export of the owned scene into a new workspace directory. |
| Select a puppet, audio or scene row in the Project panel by name. |
| Inspect, verify or continue a recorded native operation. |
| Validate exported PNG and WAV files, their hashes and the dialogue sample timing. |
| Write a pinned media receipt and a measured audio descriptor for the exported files. |
See the tool reference for parameters and results.
Closed projects and recovery
For a closed Character Animator project, prepare a copy with project_prepare_copy, open that prepared copy, inspect
its project root and claim it with session_control before editing. A WAV handoff receipt does not confirm import:
check that the audio appears in the project's Audio rows. After a process exits, the operation control and session
control tools provide explicit reconciliation and lease release actions; they preserve unknown outcomes and project
files.
Keep workspace ownership records private. Each native operation is recorded before it runs. If an operation reports an unknown outcome, inspect the application and outputs or reconcile the recorded operation before trying again. See project copies and ownership and recovery and unknown outcomes.
Documentation
The documentation source is in docs/character-animator-mcp/source:
Guides: your first result, project copies and ownership, importing and exporting, recovery and unknown outcomes and troubleshooting
Reference: tools, results and errors, configuration and testing and evaluation
Configuration
Variable | Meaning |
| Absolute directory every tool path is relative to. Required. |
| Private server state: native helper builds and Character Animator journals. Defaults to |
| The Character Animator |
Without an override the server uses the newest installed version under /Applications with the application's bundle
identifier. An override that names another application is refused with APP_IDENTITY_MISMATCH.
Security
The server speaks MCP over stdio, sends no telemetry and uses no accounts. It controls Character Animator with the
Accessibility and, for capture, Screen Recording permissions of the MCP host, so run it only for clients you
trust. Tool paths are confined to the workspace, and the tools that change the project refuse any project that is
not an owned copy. See the security model and
SECURITY.md.
Contributing
See CONTRIBUTING.md for setup, checks and the rules for changes. This project follows the Code of Conduct.
License
MIT. See LICENSE.
Trademarks
Adobe and Character Animator are either registered trademarks or trademarks of Adobe in the United States and/or other countries. This project is not affiliated with, endorsed by, or sponsored by Adobe. It does not include or redistribute Adobe software, puppets or project files; you supply your own licensed application.
Available Tools
14 toolscaptureA
Capture only the Character Animator window with bounded OCR into a new workspace directory.
Observed text/geometry are visual evidence, not native scene IDs. Never starts recording.
Inputs: directory (required). Returns: path, native, sha256, identity, +1 more
character_statusARead-onlyIdempotent
Inspect app/control availability without launch, recording or permission prompts.
Inputs: no named parameters. Returns: native, reason, available, connected, +1 more
export_ingestB
Create a pinned media receipt and measured PCM audio descriptor for Unity cutscene delivery.
Outputs go into a new directory. Preserves editable project/performance/XML provenance; does not establish native rigging, lip-sync correctness, playback or visual acceptance.
Inputs: recipe (required), directory (required). Returns: name, schema, status, handoff, +5 more
export_inspectBRead-onlyIdempotent
Validate explicitly ordered native-export PNG/WAV/source hashes and exact dialogue sample timing.
Frame rate/order are caller declarations; proprietary project/puppet files are opaque provenance. This inspects existing files and does not perform a native Character Animator export.
Inputs: recipe (required). Returns: fps, name, schema, status, +7 more
import_mediaBDestructive
Submit a hash-pinned workspace PSD puppet or WAV to the owned project.
PSDs use the native Import chooser. WAVs are handed to the already-running app; verify the project's Audio row because a handoff receipt does not confirm import.
Inputs: kind (required), source (required), lease_id (required). Returns: kind, native, source, status, +5 more
inspectCRead-onlyIdempotent
Observe actual process, project-root evidence, native controls and unresolved operation state.
Inputs: no named parameters. Returns: native, project_id, pending_operation, launches_application
operation_controlA
Inspect or continue exact pending copy/import/export operations, verify a copy, or reconcile cancellation.
continue_export resumes only the journaled Export Scene/Go To chooser and output directory. continue_import never replays File > Import and requires the existing chooser, except for the single recorded pre-menu focus rejection. confirm_cancelled_import requires explicit user attestation and matching process/root/source evidence; it issues no native command and is not native-verified cancellation. cancel_unsubmitted applies only to an observed unsubmitted Save As chooser. reconcile_unsubmitted_copy records only a closed, pre-submit initial Save As stage after stable source checks; it sends no native command and does not imply user cancellation. reconcile_copy_after_exit resolves only a submitted initial Save As after the exact app process has exited, no matching app instance is running, and the original destination remains absent; it verifies no copy. abandon_after_exit archives an unknown operation on a first-hand owned project only after two stable observations confirm the original app process and all Character Animator instances have exited. It preserves project files and records the native outcome as unknown.
Inputs: action (required), operation_id (required), lease_id, user_confirmed_cancelled. Returns: native, status, retry_safe, operation_id
project_open_prepared_copyA
Open only the exact closed-project copy previously prepared by project_prepare_copy.
Inspect the opened native root, then claim it with session_control and the same prepared_copy_id.
Inputs: prepared_copy_id (required). Returns: native, status, completion, project_id, +4 more
project_prepare_copyA
Copy a closed saved workspace .chproj tree and verify its file hashes before native opening.
The source must not be open in Character Animator. This creates only a new workspace copy; pass its prepared_copy_id to project_open_prepared_copy, inspect the opened root, then claim it with session_control and the same prepared_copy_id.
Inputs: source (required), destination (required). Returns: files, source, status, destination, +4 more
project_save_copyBDestructive
Native Save Project As into a new workspace project, then verify actual root and project files.
directory is an existing parent; name is a safe ASCII project name. Does not edit the source scene or discard unsaved state. A missing original file hash remains explicitly unavailable.
Inputs: name (required), lease_id (required), directory (required). Returns: files, status, project_id, retry_safe, +4 more
project_selectBDestructive
Select one uniquely OCR-matched Project-panel row by name and type.
extend controls additive selection; use the latest inspect fingerprint. OCR evidence is not a scene ID.
Inputs: name (required), extend (required), lease_id (required), item_type (required), +1 more. Returns: name, extend, native, status, +6 more
scene_actionADestructive
Dispatch one fixed menu action against the current owned-project selection.
Actions are add_to_new_scene, create_take_from_scene_audio, compute_lip_sync or export_png_wav. Copy the fingerprint from the latest inspect; scene/export completion remains unverified until inspected.
Inputs: action (required), lease_id (required), expected_fingerprint (required). Returns: action, status, completion, retry_safe, +5 more
scene_exportADestructive
Submit PNG Sequence and WAV for the current owned scene into a new workspace directory.
The result confirms native chooser submission only. Inspect actual files with export_inspect after export.
Inputs: name (required), lease_id (required), directory (required), expected_fingerprint (required). Returns: native, status, retry_safe, operation_id
session_controlB
Claim, renew, release, or resume a matching expired lease for one unknown operation.
Resume requires the expired lease ID, same owner, project ID and exact unknown operation ID. It renews ownership after process/root checks and dispatches no native command or chooser action. Claiming a prepared copy requires its private ID and a fresh observation of that exact native root.
Inputs: action (required), owner, lease_id, ttl_seconds, +3 more. Returns: owner, state, lease_id, expires_at, +4 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have distinct roles once descriptions are parsed, but several clusters blur together: session_control (lease claim/renew/release/resume) vs operation_control (inspect/continue/reconcile pending operations) both deal with unknown-operation state, and project_prepare_copy vs project_save_copy vs project_open_prepared_copy vs export_ingest all involve copying/opening/exporting project trees. The dense prose helps disambiguate but still demands careful reading, so an agent could misselect between the lease and operation control paths.
There is a loose resource-prefix scheme (character_, project_, scene_, export_, session_, operation_), but ordering is mixed: noun_verb (export_ingest, export_inspect), verb_noun (import_media, project_save_copy), and bare verbs (inspect, capture) all coexist. Readable overall, but no single predictable pattern.
14 tools is within the appropriate band for a complex, multi-stage native-app orchestration domain (status, inspect, copy lifecycle, media import, scene actions, export verification). Each tool maps to a distinct workflow stage, though the operation_control mega-tool absorbs many sub-actions that could be counted separately.
The surface covers the full lifecycle: status/inspect/capture observation, project copy preparation and opening, media import, native scene actions and export, plus export hash inspection and Unity delivery receipt. Gaps are minor — no explicit app launch/close or undo/restore tool — but core workflows appear end-to-end covered.
Maintenance
Related MCP Connectors
Compose, edit and render video with your AI agent. Turn footage into finished edits with content-aware reframing, word-timed captions and motion graphics. Hosted MCP with OAuth sign-in; cloud processing uses credits.
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
Creator MCP is the hosted LottieFiles animation engine for AI agents. Your agent builds real motion with layers, shapes and keyframes, then exports MP4, WebM, Lottie or dotLottie. Use it for logo reveals, product promos, social clips and UI animations. You can import SVGs, images and existing Lottie files, and open any scene in Lottie Creator to fine-tune it frame by frame. Setup is one URL and a LottieFiles sign-in.
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables local control of Adobe After Effects via MCP, offering offline creative skills, project inspection, and operation execution without cloud relay or an installed AE panel.122,219 npm13MIT
- AlicenseBqualityBmaintenanceConnects an MCP client to a locally installed Adobe Premiere Pro so editors can inspect projects and run structured editing operations—project creation and opening, linked audio/video insertion and trimming, cutting, SRT caption rendering, and native MP4 export—instead of navigating the UI repeatedly. Capability profiles limit access to inspection, editing, export, or filesystem authority as needed for each task.389MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to control a local video editor through authenticated stdio commands for clips, effects, text, subtitles, camera, graphics, keyframes, audio, and export.MIT
- AlicenseBqualityCmaintenanceEnables any MCP client to control After Effects, Premiere Pro, Photoshop and Illustrator through 182 native tools plus 500+ bundled community tools, covering layer/comp editing, rendering, export, plugin and extension discovery, and media downloads. Cross-app workflows move comps, layers, frames and MOGRTs between applications, while raw scripting escape hatches reach nearly any menu command or plugin action.1821MIT