Skip to content
Back to search

excalimate

Create keyframe animations from hand-drawn Excalidraw diagrams — timeline editor, camera animation, sequence reveals, and an MCP server for AI-driven creation with real-time live preview Export as MP4, WebM, GIF, or animated SVG.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/excalimate/excalimate with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/excalimate/excalimate'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/excalimate--excalimate/badge.svg)](/listings/excalimate--excalimate)

HTML

<a href="/listings/excalimate--excalimate"><img src="/api/listings/excalimate--excalimate/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Try it now** — no cloning required:

npx @excalimate/mcp-server

Point your AI tool to `http://127.0.0.1:3001/mcp`. After it connects, copy the printed preview pairing URL into **File → Preferences** in [app.excalimate.com](https://app.excalimate.com), then click **Live**.

Local development

npm install
npm run dev
# → http://localhost:5173

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 269 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="public/excalimate_logo_dark.svg">
  4. <source media="(prefers-color-scheme: light)" srcset="public/excalimate_logo.svg">
  5. <img src="public/excalimate_logo.svg" width="280" alt="Excalimate">
  6. </picture>
  7. _Turn hand-drawn Excalidraw diagrams into keyframe animations_
  8. [![npm version](https://img.shields.io/npm/v/@excalimate/mcp-server?style=flat-square)](https://www.npmjs.com/package/@excalimate/mcp-server)
  9. [![npm downloads](https://img.shields.io/npm/dm/@excalimate/mcp-server?style=flat-square)](https://www.npmjs.com/package/@excalimate/mcp-server)
  10. [![license](https://img.shields.io/github/license/excalimate/excalimate?style=flat-square)](LICENSE)
  11. [![GitHub stars](https://img.shields.io/github/stars/excalimate/excalimate?style=flat-square)](https://github.com/excalimate/excalimate)
  12. [App](https://app.excalimate.com) · [Landing Page](https://excalimate.com) · [Feedback](https://excalimate.com/feedback) · [MCP Server Docs](mcp-server/README.md) · [Report Bug](https://github.com/excalimate/excalimate/issues)
  13. </div>
  14. Draw diagrams with the full Excalidraw editor, then animate elements with opacity fades, position slides, scale effects, rotation, and arrow draw-on animations. Export as MP4, WebM, GIF, or animated SVG. Includes an **MCP server** so AI agents can create and animate diagrams in real-time.
  15. [![@excalimate/mcp-server MCP server](https://glama.ai/mcp/servers/excalimate/excalimate/badges/card.svg)](https://glama.ai/mcp/servers/excalimate/excalimate)
  16. ## Demo
  17. https://github.com/user-attachments/assets/77e87c62-0ff4-4a56-aee6-50553b94798c
  18. > [!CAUTION]
  19. > A considerable part of this codebase was built with AI. The process of cleaning up the code and fixing bugs is still ongoing — use it cautiously. If you encounter any issues, please [report them](https://github.com/excalimate/excalimate/issues).
  20. ## Features
  21. - **Full Excalidraw editor** — draw, edit, resize, connect arrows, add text
  22. - **Progressive V2 creator** — Magic Canvas, plain-language Sequence, and Advanced Studio
  23. - **Local animation tools** — deterministic Auto Animate, presets, templates, and Smart Transitions
  24. - **Keyframe animation** — opacity, position, scale, rotation, draw progress
  25. - **Advanced timeline** — collapsible per-element tracks with interpolation lines, clip markers, scrubbing
  26. - **Camera animation** — pan/zoom keyframes with aspect ratio control
  27. - **Unified export** — MP4, WebM, GIF, animated SVG, Lottie, and dotLottie
  28. - **Hosted player and embeds** — compact playback runtime with responsive controls
  29. - **E2E encrypted sharing** — expiry and revocation with the AES-256-GCM key kept in the URL hash
  30. - **MCP server** — 35 tools, including all 29 legacy tools and six structured V2 action tools
  31. - **Live mode** — watch AI changes appear in the editor in real-time via SSE
  32. ## Quick Start
  33. **Try it now** — no cloning required:
  34. ```bash
  35. npx @excalimate/mcp-server
  36. ```
  37. Point your AI tool to `http://127.0.0.1:3001/mcp`. After it connects, copy the
  38. printed preview pairing URL into **File → Preferences** in
  39. [app.excalimate.com](https://app.excalimate.com), then click **Live**.
  40. ### Local development
  41. Use Node.js 24, the version used by CI.
  42. ```bash
  43. npm install
  44. npm run dev
  45. # → http://localhost:5173
  46. ```
  47. ## AI Integration (MCP Server)
  48. The MCP server lets AI agents (Copilot, Claude, Cursor, Windsurf) create and animate diagrams for you. Start the server, connect your AI tool, and watch diagrams appear live in [app.excalimate.com](https://app.excalimate.com).
  49. The recommended workflow is action-first: create a scene, then use `auto_animate`, `apply_animation_preset`, `upsert_action_sequence`, or `create_camera_move` before reaching for raw keyframes. These tools use the same browser-neutral V2 schema and deterministic animation core as the app stack. The MCP server does not host a model or send scene content to an AI service.
  50. ```bash
  51. npx @excalimate/mcp-server # default port 3001
  52. npx @excalimate/mcp-server --port 4000 # custom port
  53. ```
  54. <details>
  55. <summary><strong>VS Code (GitHub Copilot)</strong></summary>
  56. Add to `.vscode/mcp.json`:
  57. ```jsonc
  58. {
  59. "servers": {
  60. "excalimate": {
  61. "type": "http",
  62. "url": "http://localhost:3001/mcp",
  63. },
  64. },
  65. }
  66. ```
  67. </details>
  68. <details>
  69. <summary><strong>Claude Desktop</strong></summary>
  70. Add to `claude_desktop_config.json`:
  71. ```json
  72. {
  73. "mcpServers": {
  74. "excalimate": {
  75. "command": "npx",
  76. "args": ["@excalimate/mcp-server", "--stdio"]
  77. }
  78. }
  79. }
  80. ```
  81. > [!NOTE]
  82. > Claude Desktop uses stdio transport — no live preview. Use `save_checkpoint`, import the V2 project in [app.excalimate.com](https://app.excalimate.com), then share from the authenticated browser UI.
  83. </details>
  84. <details>
  85. <summary><strong>Claude Code (CLI)</strong></summary>
  86. ```bash
  87. npx @excalimate/mcp-server &
  88. claude mcp add excalimate http://localhost:3001/mcp
  89. ```
  90. </details>
  91. <details>
  92. <summary><strong>Cursor / Windsurf / Other HTTP clients</strong></summary>
  93. Point your MCP client to `http://localhost:3001/mcp` and start the server with `npx @excalimate/mcp-server`.
  94. </details>
  95. > [!TIP]
  96. > HTTP mode (default) enables **live preview** — you see the AI's changes in real-time. stdio mode is only needed for tools that don't support HTTP transport.
  97. See [mcp-server/README.md](mcp-server/README.md) for the full tool reference and configuration guide.
  98. ### AI Skills (Optional)
  99. Excalimate ships with **16 specialized skills** that teach AI agents how to create specific diagram types (architecture diagrams, flowcharts, sequence diagrams, etc.) with proper animation patterns. Skills dramatically improve output quality.
  100. **GitHub Copilot (recommended):**
  101. ```bash
  102. npx skills add https://github.com/excalimate/excalimate
  103. ```
  104. **Manual installation (any agent):**
  105. Copy the `skills/` directory into your project, or point your agent's skill/context configuration to the skill files. Each skill is a standalone `SKILL.md` file that can be loaded as context.
  106. **Available skills:** `excalimate-core` · `animated-presentations` · `animation-patterns` · `architecture-diagrams` · `comparison-diagrams` · `data-pipelines` · `diagram-theming` · `er-diagrams` · `explainer-animations` · `export-optimization` · `flowcharts` · `mind-maps` · `network-topologies` · `org-charts` · `sequence-diagrams` · `timeline-roadmaps`
  107. ## Usage
  108. ### V2 creator workflow
  109. 1. Draw with the full Excalidraw editor or start from an animated template.
  110. 2. Use **Magic** to preview local Auto Animate, apply a preset, or create a Smart Transition between captured scene states.
  111. 3. Use **Sequence** to reorder actions and adjust plain-language timing such as after or with the previous action.
  112. 4. Open **Studio** for the preserved advanced timeline, custom keyframes, clip range, camera, and per-track controls.
  113. 5. Export a video, image, animated SVG, Lottie, or dotLottie, or create an encrypted expiring share link for hosted playback.
  114. ### Sharing
  115. Share your animation via **File → Share**. The project is encrypted client-side with AES-256-GCM and uploaded as an opaque blob — the server never sees the encryption key.
  116. ## Architecture
  117. ```
  118. excalimate/
  119. ├── src/ # React web app (Vite + TypeScript)
  120. │ ├── components/ # UI (Mantine + Tailwind CSS)
  121. │ ├── core/ # Animation engine, interpolation, playback
  122. │ ├── stores/ # Zustand state management
  123. │ ├── services/ # Export pipeline, encryption, file I/O
  124. │ └── hooks/ # MCP live, hotkeys, auto-save
  125. ├── mcp-server/ # MCP server (Node.js + Express)
  126. │ └── src/server/ # Modular tool registrations
  127. ├── packages/
  128. │ ├── project-schema/ # Shared V2 project codec and validation
  129. │ ├── animation-core/ # Shared deterministic action compiler/runtime
  130. │ ├── player-runtime/ # Hosted player package, sanitizer, playback
  131. │ └── export-runtime/ # Unified export sampling and workers
  132. ├── skills/ # AI skill definitions (16 skills)
  133. └── docs/ # Design guidelines, plans
  134. ```
  135. The web app is a **static SPA** — all rendering, animation, and editing happens in the browser. The MCP server is optional, used only for AI integration and live preview.
  136. ## Excalimate V2 documentation
  137. - [Migration, architecture, limits, rollout, and rollback](docs/v2-release.md)
  138. - [Magic, Sequence, Studio, templates, and transitions](docs/v2-user-guide.md)
  139. - [Hosted player and embedding](docs/hosted-player.md)
  140. - [MCP V2 and deprecations](docs/mcp-v2.md)
  141. - [Security, sharing retention, and deployment](docs/security-and-sharing.md)
  142. - [Accessibility validation matrix](docs/accessibility.md)
  143. - [Export runtime and format fallbacks](docs/export-runtime.md)
  144. ## Tech Stack
  145. | Layer | Technology |
  146. | ---------- | --------------------------------------------------- |
  147. | UI | React 19, Mantine 8, Tailwind CSS 4, Tabler Icons |
  148. | Canvas | Excalidraw 0.18 |
  149. | State | Zustand |
  150. | Animation | Custom keyframe engine with interpolation + easing |
  151. | Export | WebCodecs (MP4/WebM), gif.js, SVG |
  152. | Encryption | Web Crypto API (AES-256-GCM) |
  153. | MCP Server | Node.js, Express, MCP SDK |
  154. | Build | Vite 7, TypeScript 5.9 |
  155. | Deployment | Cloudflare Pages, Cloudflare Workers, Cloudflare R2 |
  156. ## Development
  157. ```bash
  158. npm run dev # Start dev server
  159. npm run build # Production build
  160. npm run test # Run tests
  161. npm run lint # ESLint
  162. ```
  163. ### Privacy-sensitive deployment settings
  164. The privacy notice depends on production configuration as well as source code:
  165. - Configure the landing-page Cloudflare Workers build with root directory
  166. `landing-page`, build command `npm run build`, and deploy command
  167. `npx wrangler versions upload --config dist/server/wrangler.json`. The
  168. Cloudflare adapter generates that server configuration during the build.
  169. - Use only Cloudflare edge/zone aggregate traffic analytics. Do not enable the
  170. Cloudflare Web Analytics browser beacon or export request logs for analytics.
  171. - Do not describe or use Cloudflare's IP-derived unique-visitor metric as
  172. anonymous. Delete raw/exported Cloudflare reports within 30 days; aggregate
  173. trend reports may be retained without a fixed limit.
  174. - Keep PostHog on Cloud EU with IP capture, autocapture, session replay, surveys,
  175. product tours, web experiments, and feature flags disabled. Set event retention
  176. to no more than 12 months and review the DPA and subprocessors before release.
  177. - Retain the legitimate-interest and ePrivacy assessments for Cloudflare,
  178. GitHub's star-count request, and the pinned unpkg dotLottie runtime. Review the
  179. DPIA screening, Article 30 record, and any transfer assessment when a data flow
  180. changes.
  181. - Obtain legal approval for the deployed notice and account settings. If the
  182. GitHub or unpkg request cannot rely on the documented ePrivacy position in a
  183. target jurisdiction, self-host/proxy it or gate it before release.
  184. MCP server:
  185. ```bash
  186. npm install
  187. npm run build --workspace @excalimate/project-schema
  188. npm run build --workspace @excalimate/animation-core
  189. npm run build --workspace @excalimate/mcp-server
  190. cd mcp-server
  191. node dist/index.js # HTTP mode
  192. node dist/index.js --stdio # stdio mode
  193. node dist/index.js --port 4000 # custom port
  194. ```
  195. ## Acknowledgements
  196. This project was inspired by [excalidraw-animate](https://github.com/dai-shi/excalidraw-animate) by [Daishi Kato](https://github.com/dai-shi), which demonstrated that Excalidraw drawings could be brought to life with animations. Thank you for the inspiration!
  197. Built with [Excalidraw](https://excalidraw.com) — the amazing open-source virtual whiteboard.
  198. ## License
  199. MIT — see [LICENSE](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.