Skip to main content
Glama

Cavi Adobe MCP

PyPI weekly downloads

A paper theatre with a fox arranging a whale and stars

Keep the magic editable.

Tell your assistant what to change. Keep the Photoshop layers, Illustrator paths and Animate timeline.

Cavi Adobe MCP connects your MCP client to native Adobe projects through application-specific local servers, with editable working copies and supported animation and render handoffs.

Ask for outcomes in your own words:

  • “Make a working copy of this illustration, add editable text and export a preview.”

  • “Build an Animate timeline from this artwork, then export its frames.”

  • “Export the Animate frames and make a review movie.”

Four local servers cover different jobs: Photoshop and Illustrator authoring and review movies; Animate timeline authoring; Character Animator project and scene workflows; and Dimension inspection and rendering. Their capabilities differ by application.

Related MCP server: workspace-mcp

The Adobe suite

Each larger application has its own package. Install the ones you use.

Applications

Package

Install

Photoshop, Illustrator, Animate, Character Animator, Dimension

Cavi Adobe MCP (this repository)

uv tool install cavi-adobe-mcp

After Effects

Cavi After Effects MCP

uv tool install cavi-after-effects-mcp

Premiere Pro

Cavi Premiere MCP

uv tool install cavi-premiere-mcp

Substance 3D Painter, Designer, Sampler

Cavi Substance MCP

uv tool install cavi-substance-mcp

Requirements

  • macOS, Python 3.15+ and uv.

  • The licensed Adobe applications you use, installed and signed in.

  • Automation access for the MCP host to control the application (Photoshop, Illustrator, Animate).

  • Animate and Character Animator also use a small native helper compiled on first use, which needs the Swift command-line compiler (xcode-select --install) and existing Accessibility access. Character Animator capture also needs Screen Recording access.

  • ffmpeg on PATH for review movies.

Install

uv tool install cavi-adobe-mcp

The package installs four commands:

Command

Application

cavi-adobe-authoring-mcp

Photoshop, Illustrator and review movies

cavi-animate-mcp

Animate

cavi-character-animator-mcp

Character Animator

cavi-dimension-mcp

Dimension

Register the servers you need in your MCP client and set the workspace:

{
  "mcpServers": {
    "adobe-authoring": {
      "command": "cavi-adobe-authoring-mcp",
      "env": {"CAVI_ADOBE_WORKSPACE": "/Users/me/Art"}
    }
  }
}

Configuration

Variable

Meaning

CAVI_ADOBE_WORKSPACE

Absolute directory every tool path is relative to. Required.

CAVI_ADOBE_DATA

Private server state: native helper builds and Character Animator journals. Defaults to ~/.local/share/cavi-adobe-mcp.

CAVI_PHOTOSHOP_APP

The Photoshop .app to use.

CAVI_ILLUSTRATOR_APP

The Illustrator .app to use.

CAVI_ANIMATE_APP

The Animate 2024 .app to use.

CAVI_CHARACTER_ANIMATOR_APP

The Character Animator .app to use.

Without an override each server uses the newest installed version under /Applications with the application's bundle identifier. An override is final: one that names another application is refused with APP_IDENTITY_MISMATCH. Dimension is driven only at /Applications/Adobe Dimension/Adobe Dimension.app.

Ownership records live inside the workspace (.adobe-authoring/, .animate-authoring/); keep them private.

Authoring supports inspection, owned copies, canvas and layer edits, text, paths, masks and export. Animate supports editable timelines and frame export. Character Animator supports project, scene, capture and export workflows. Dimension supports inspection and rendering. FFmpeg can create review movies.

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.

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.

Development

uv sync --locked --dev
uv run --locked python -m unittest discover -s tests
uv run --locked ruff check .

Evaluation configuration is in evals.

License

MIT. Adobe, Photoshop, Illustrator, After Effects, Premiere Pro, Substance 3D, Animate, Character Animator and Dimension are trademarks of Adobe Inc.; this project is not affiliated with Adobe.

Available Tools

17 tools
adobe_add_groupC
Destructive

Create a named group for editable motifs or layered cartoon source parts.

Inputs: name (required), session_id (required), application (required), parent_path, +1 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_add_pathB
Destructive

Create retained editable Bézier geometry, optionally filled; coordinates use px/pt from top left.

Inputs: name (required), points (required), session_id (required), application (required), +4 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_add_rectangleC
Destructive

Add a filled motif or mask on a new layer; bounds are x,y,width,height in px/pt.

Inputs: rgb (required), name (required), bounds (required), session_id (required), +2 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_add_textC
Destructive

Create editable native text using an exact discovered PostScript font and point size.

Inputs: rgb (required), font (required), name (required), size (required), +4 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_apply_maskC
Destructive

Apply a retained named path as a PS layer mask or Illustrator clipping group.

Inputs: path_name (required), layer_path (required), session_id (required), application (required), +1 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_close_copyB
Destructive

Save and close only the exact cooperatively owned copy; original documents are not targeted.

Inputs: session_id (required), application (required). Returns: copy, document, retry_safe, session_id, +2 more

adobe_create_canvasB

Create a transparent 72 ppi sRGB Photoshop canvas; default depth is 16-bit.

Inputs: width (required), height (required), destination (required), bit_depth. Returns: copy, document, retry_safe, session_id, +5 more

adobe_edit_layersA
Destructive

Rename, hide/show or change opacity of exact paths with expected names in an owned copy.

Inputs: edits (required), session_id (required), application (required). Returns: copy, document, retry_safe, session_id, +2 more

adobe_exportC

Export native-depth Photoshop PNG or vector Illustrator SVG by default; PNG24 is explicit.

Inputs: session_id (required), application (required), destination (required), kind, +1 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_fontsB
Read-onlyIdempotent

List native font families, styles and exact PostScript names.

Inputs: application (required). Returns: fonts, runtime, pending_operation

adobe_inspectB
Read-onlyIdempotent

Read native document/layer identities; an unknown command blocks later mutations.

Inputs: application (required), session_id. Returns: runtime, pending_operation

adobe_open_copyB

Open a new owned PSD/AI copy from workspace PSD/AI/PNG/SVG. Destination must be new.

Inputs: source (required), application (required), destination (required). Returns: copy, document, retry_safe, session_id, +2 more

adobe_operation_controlC
Destructive

Inspect retained completion; adopt a saved owned copy with both observed hashes, or abandon after app exit.

Inputs: session_id (required), application (required), operation_id (required), action, +2 more. Returns: state, document, retry_safe, session_id, +5 more

adobe_place_imageC
Destructive

Embed an existing PNG in a named group; x/y uses Photoshop pixels or Illustrator points.

Inputs: name (required), source (required), position (required), session_id (required), +3 more. Returns: copy, document, retry_safe, session_id, +2 more

adobe_resize_imageB
Destructive

Resample an owned Photoshop PSD to pixel dimensions while retaining editable layers and paths.

Inputs: width (required), height (required), session_id (required), application (required). Returns: copy, document, retry_safe, session_id, +2 more

adobe_statusB
Read-onlyIdempotent

Inspect installation and running process only; no app launch or Apple events.

Inputs: application (required). Returns: app, running, version, application, +2 more

media_review_movieC

Run free local FFmpeg/ffprobe on pinned frames; MOV retains alpha, MP4 explicitly composites black.

Inputs: receipt (required), directory (required), codec. Returns: path, codec, sha256, stream, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 17 tools

    Disambiguation4/5

    Most tools target distinct resources and actions (open_copy vs create_canvas vs resize_image vs export), and descriptions clarify the boundaries. Minor overlap exists among the three state-reading tools (adobe_inspect, adobe_status, adobe_operation_control), and add_path vs add_rectangle could be conflated, but these are resolvable from the descriptions.

    Naming Consistency4/5

    The adobe_verb_noun pattern is used across most tools (adobe_open_copy, adobe_add_text, adobe_apply_mask), with a few noun-only names (adobe_status, adobe_fonts, adobe_operation_control) and one tool (media_review_movie) using a different prefix for a distinct media-review domain. Overall predictable and readable with minor deviations.

    Tool Count4/5

    17 tools is slightly above the ideal 3-15 range but justified by the dual Photoshop/Illustrator authoring domain plus a media review utility. Each tool earns its place covering distinct operations rather than duplicating functionality.

    Completeness4/5

    The surface covers a full lifecycle: open/create, inspect, add elements (text, path, rectangle, group, image), edit layers, apply masks, resize, export, and close/adopt. Minor gaps exist—no layer deletion/reordering or move/transform operations—but core authoring workflows are well supported.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to safely read, write, edit, search, and optionally run commands within one or more named project workspaces, while maintaining a work journal and tracking changes.
      19
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to automate and inspect Adobe Photoshop, Premiere Pro, After Effects, and Illustrator through a secure, typed MCP surface with schema-validated operations, risk-classified plans, artifacts, and verification. Bridges translate safe domain commands into UXP, CEP, ExtendScript, or approved CLI work without exposing arbitrary scripts or shell access.
      MIT