Cavi Adobe Authoring MCP
This server lets an MCP client inspect Photoshop/Illustrator, author and export editable native documents through owned working copies, reconcile uncertain operations, render After Effects comps, and build review movies from frames.
Check Photoshop/Illustrator installation/running status, inspect native document/layer identities, and list available fonts.
Open new owned PSD/AI copies from PSD, AI, PNG, or SVG, and create transparent Photoshop canvases.
Edit owned copies: resize PSDs; rename, show/hide, or change layer opacity; add groups, embedded PNGs, rectangles, Bézier paths, and editable text; apply paths as Photoshop masks or Illustrator clipping groups.
Export native-depth PNGs or Illustrator SVGs, with PNG24 explicit, and save/close owned copies.
Reconcile retained operations after unknown outcomes, adopt saved copies with observed hashes, or abandon after app exit.
Render declared After Effects comps with aerender into new PNG directories under time/memory limits.
Create local FFmpeg/ffprobe review movies from pinned frames, with alpha-preserving MOV or black-composited MP4.
Uses FFmpeg (found on PATH) to produce review movies of authored work, available through the media_review_movie tool alongside After Effects aerender output so edits and renders can be reviewed as video.
Click 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 Adobe Authoring MCP Open hero.psd, add a text layer, and export a PNG preview"
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 Adobe MCP

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) |
|
After Effects |
| |
Premiere Pro |
| |
Substance 3D Painter, Designer, Sampler |
|
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.ffmpegonPATHfor review movies.
Install
uv tool install cavi-adobe-mcpThe package installs four commands:
Command | Application |
| Photoshop, Illustrator and review movies |
| Animate |
| Character Animator |
| 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 |
| Absolute directory every tool path is relative to. Required. |
| Private server state: native helper builds and Character Animator journals. Defaults to |
| The Photoshop |
| The Illustrator |
| The Animate 2024 |
| The Character Animator |
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 toolsadobe_add_groupCDestructive
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_pathBDestructive
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_rectangleCDestructive
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_textCDestructive
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_maskCDestructive
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_copyBDestructive
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_layersADestructive
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_fontsBRead-onlyIdempotent
List native font families, styles and exact PostScript names.
Inputs: application (required). Returns: fonts, runtime, pending_operation
adobe_inspectBRead-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_controlCDestructive
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_imageCDestructive
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_imageBDestructive
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_statusBRead-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
Scored across 17 tools
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.
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.
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.
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
Related MCP Connectors
Hosted remote MCP for protected account access, permissions, activity history and supported undo.
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.
Hosted video MCP server for branded explainers and reference-driven edits.
Remote MCP for C2PA intake verifier MCP, structured receipts, audit logs, and reviewer-ready evidenc
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
- AlicenseAqualityBmaintenanceEnables 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.19MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to perform validated, authenticated project, timeline, media, marker, and export-queue operations in Adobe's video editor through a local UXP panel. It supports safe previews and explicit approval for destructive actions.5,578 npmMIT