# @open-pencil/mcp Latest version **0.15.0** (published 2026-09-16) · MIT license · 0 weekly downloads ## Install ```sh npm install @open-pencil/mcp pnpm add @open-pencil/mcp yarn add @open-pencil/mcp bun add @open-pencil/mcp ``` ## Health **Score 55/100 (C)** — status: active. Positive: no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types; no esm support; pre 1.0. ## Facts | | | |---|---| | Version | 0.15.0 | | Published | 2026-09-16 | | First published | 2026-03-02 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 8361 | | Maintainers | dannote | ## Links - npm: https://www.npmjs.com/package/@open-pencil/mcp - Repository: https://github.com/open-pencil/open-pencil - Homepage: https://github.com/open-pencil/open-pencil#readme - Issues: https://github.com/open-pencil/open-pencil/issues - npm.io page: https://npm.io/package/@open-pencil/mcp ## Recent versions - 0.15.0 (latest) — 2026-09-16 - 0.14.0 — 2026-08-11 - 0.13.2 — 2026-05-30 - 0.13.1 — 2026-05-29 - 0.13.0 — 2026-05-29 - 0.12.2 — 2026-05-19 - 0.12.1 — 2026-05-19 - 0.12.0 — 2026-05-18 - 0.11.8 — 2026-04-23 - 0.11.7 — 2026-04-22 - 0.11.6 — 2026-04-08 - 0.11.5 — 2026-04-08 - 0.11.4 — 2026-04-08 - 0.11.2 — 2026-03-30 - 0.11.1 — 2026-03-30 - … 11 more at https://npm.io/package/@open-pencil/mcp/versions ## README # OpenPencil [![MIT license](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![npm](https://img.shields.io/npm/v/@open-pencil/cli?label=%40open-pencil%2Fcli)](https://www.npmjs.com/package/@open-pencil/cli) [![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/4wXc9fuZfm) [![GitHub Discussions](https://img.shields.io/github/discussions/open-pencil/open-pencil?logo=github&label=Discussions)](https://github.com/open-pencil/open-pencil/discussions) Open-source design editor. Opens `.fig` and `.pen` design files, includes built-in AI, and ships as a programmable toolkit with a headless Vue SDK for building custom editors. > **Status:** Active development. Usable today, with some rough edges as features evolve. **[Try it online →](https://app.openpencil.dev/demo)** · [Download](https://github.com/open-pencil/open-pencil/releases/latest) · [Documentation](https://openpencil.dev) · [Roadmap](https://openpencil.dev/development/roadmap) · [llms.txt](https://openpencil.dev/llms.txt) ![OpenPencil](packages/docs/public/screenshot.png) ## Installation **macOS (Homebrew):** ```sh brew install --cask openpencil ``` Or download from the [releases page](https://github.com/open-pencil/open-pencil/releases/latest), or [use the web app](https://app.openpencil.dev) — no install needed. ## What it does - **Opens `.fig` and `.pen` files** — read and write native Figma files, open supported Pencil documents from the app or OS file browser, copy & paste nodes between apps - **AI builds designs** — describe what you want in chat, 100+ tools create and modify nodes. Connect OpenRouter, Anthropic, OpenAI, Google AI, DeepSeek, Z.ai, MiniMax, or compatible endpoints - **Fully programmable** — headless CLI, XPath queries, Figma Plugin API via `eval`, MCP server for AI agents, and desktop agent integrations for Claude Code, Codex, and Gemini CLI - **Lint, convert, and extract tokens** — inspect documents, lint naming/layout/accessibility, convert between supported formats, analyze colors/typography/spacing/clusters, and extract design tokens - **Components and variants** — create reusable components, group variants into component sets, insert local assets as instances, and switch variants from the inspector - **Image vectorization** — convert image layers into editable vector layers with Recraft or fal.ai - **Design-to-code export** — export selections as JSX/Tailwind, generate token outputs, and map designs into component-oriented code workflows - **Vue SDK for custom editors** — headless components and composables for embedding OpenPencil into other apps or building workflow-specific editing surfaces. [Read the SDK docs →](https://openpencil.dev/programmable/sdk/) - **Real-time collaboration** — P2P via WebRTC, no server, no account. Cursors, presence, follow mode - **Auto layout & CSS Grid** — flex and grid layout via Yoga WASM, with gap, padding, alignment, track sizing - **~15 MB desktop app** — Tauri v2 for macOS, Windows, Linux. Also runs in the browser as a PWA ## CLI ```sh npm install -g @open-pencil/cli # or: bun add -g @open-pencil/cli ``` ### Inspect design files Browse node trees, search by name or type, dig into properties — all without opening the editor: ```sh openpencil tree design.fig openpencil find design.pen --type TEXT openpencil node design.fig --id 1:23 openpencil info design.fig ``` ``` [0] [page] "Getting started" (0:46566) [0] [section] "" (0:46567) [0] [frame] "Body" (0:46568) [0] [frame] "Introduction" (0:46569) [0] [frame] "Introduction Card" (0:46570) [0] [frame] "Guidance" (0:46571) ``` ### Query with XPath Use XPath selectors to find nodes by type, attributes, and structure: ```sh openpencil query design.fig "//FRAME" # All frames openpencil query design.fig "//FRAME[@width < 300]" # Frames under 300px openpencil query design.fig "//TEXT[contains(@name, 'Button')]" # Text with 'Button' in name openpencil query design.fig "//*[@cornerRadius > 0]" # Rounded corners openpencil query design.fig "//SECTION//TEXT" # Text inside sections ``` ### Export Render to PNG, JPG, WEBP, SVG, PDF, PPTX, HTML, JSX, or `.fig` — or export selections/pages as `.fig` and convert whole documents between supported formats: ```sh openpencil export design.fig # PNG openpencil export design.fig -f jpg -s 2 -q 90 # JPG at 2x, quality 90 openpencil export design.fig -f fig --page "Page 1" # Export a page as .fig openpencil export design.fig -f jsx --style tailwind # Tailwind JSX openpencil export design.fig -f html --css tailwind # Tailwind HTML fragment openpencil export design.fig -f html --html standalone --assets external # HTML + assets openpencil convert design.pen output.fig # Convert between document formats openpencil import page.html --css styles.css -o page.fig # HTML/CSS → editable .fig ``` DOM/CSS input flows through `@open-pencil/dom-css`, so HTML, authored CSS, and Tailwind utility CSS can become editable OpenPencil layers: ```sh openpencil import card.html --css card.css -o card.fig openpencil import card.html --tailwind "flex flex-col gap-3 w-80 p-6 rounded-xl bg-white" -o card.fig ``` ```html

Card Title

Description text

``` ### Lint design files Catch naming, layout, structure, and accessibility issues from the terminal: ```sh openpencil lint design.fig openpencil lint design.pen --preset strict openpencil lint design.fig --rule color-contrast openpencil lint design.fig --list-rules ``` ### Analyze and extract design tokens Audit an entire design system from the terminal — find inconsistencies, extract the real palette, and spot components waiting to be extracted: ```sh openpencil analyze colors design.fig openpencil analyze typography design.fig openpencil analyze spacing design.fig openpencil analyze clusters design.fig openpencil analyze overlaps design.fig openpencil variables design.fig ``` ``` #1d1b20 ██████████████████████████████ 17155× #49454f ██████████████████████████████ 9814× #ffffff ██████████████████████████████ 8620× #6750a4 ██████████████████████████████ 3967× 3771× frame "container" (100% match) size: 40×40, structure: Frame > [Frame] 2982× instance "Checkboxes" (100% match) size: 48×48, structure: Instance > [Frame] ``` ### Script with Figma Plugin API `eval` gives you the full Figma Plugin API. Modify the file, write it back: ```sh openpencil eval design.fig -c "figma.currentPage.children.length" openpencil eval design.fig -c "figma.currentPage.selection.forEach(n => n.opacity = 0.5)" -w ``` ### Control the running app When the desktop app is running, omit the file argument — the CLI connects via RPC and operates on the live canvas. Useful for automation scripts, CI pipelines, or AI agents that need to interact with the editor: ```sh openpencil tree # Inspect the live document openpencil export -f png # Screenshot the current canvas openpencil eval -c "figma.currentPage.name" # Query the editor ``` All commands support `--json` for machine-readable output. ## AI & MCP ### Built-in chat Press ⌘J (CtrlJ on Windows and Linux) to open the AI assistant. It has 100+ tools that can create shapes, set fills and strokes, manage auto-layout, work with components and variables, run boolean operations, analyze design tokens, and export assets. Bring your own API key for OpenRouter, Anthropic, OpenAI, Google AI, DeepSeek, Z.ai, MiniMax, or compatible endpoints. No backend, no account. Not every provider works in the browser, and not every model streams tool calls correctly. See [BYOK provider & model compatibility](packages/docs/programmable/byok-provider-compatibility.md) for measured results — contributions welcome. ### Coding agents (desktop) Use Claude Code, Codex, or Gemini CLI directly in the chat panel. The agent connects to the editor's MCP server and uses all 100+ design tools. Requires the desktop app and the agent CLI installed locally. Pi is also available as an optional AI SDK Harness provider. Install its companion CLI with `npm install -g @open-pencil/harness`, then add a **Pi** model profile in **Settings → AI & agents**. The companion is installed separately so OpenPencil does not bundle a JavaScript runtime for users who do not enable Harness providers. **Setup (Claude Code):** 1. Install the ACP adapter: `npm install -g @agentclientprotocol/claude-agent-acp` 2. Add MCP permission to `~/.claude/settings.json`: ```json { "permissions": { "allow": ["mcp__open-pencil__*"] } } ``` 3. Open the desktop app → ⌘J → select **Claude Code** from the provider dropdown ### MCP server Connect Claude Code, Cursor, Windsurf, or any MCP client to inspect, modify, and export design documents headlessly. 100+ tools. [Full docs →](https://openpencil.dev/programmable/mcp-server) **Stdio** (Claude Code, Cursor, Windsurf): ```sh npm install -g @open-pencil/mcp claude mcp add --scope user open-pencil -- openpencil-mcp ``` For other MCP clients: ```json { "mcpServers": { "open-pencil": { "command": "openpencil-mcp" } } } ``` **HTTP** (scripts, CI): ```sh openpencil-mcp-http # Unix socket on macOS/Linux + http://127.0.0.1:7600/mcp ``` Local clients discover the private Unix socket automatically and fall back to localhost TCP. Set `PORT=0` to disable TCP on macOS/Linux. **File access:** Set `OPENPENCIL_MCP_ROOT` to scope file operations (`open_file`, `new_document`, export `path` param) to a directory. Defaults to the current working directory. ### [AI agent skill](skills/open-pencil/SKILL.md) Teach your AI coding agent to use OpenPencil — inspect designs, export assets, analyze tokens, modify .fig files: ```sh npx skills add open-pencil/open-pencil ``` Works with Claude Code, Cursor, Windsurf, Codex, and any agent that supports [skills](https://skills.sh). For documentation-aware agents, the docs site publishes [llms.txt](https://openpencil.dev/llms.txt), [llms-full.txt](https://openpencil.dev/llms-full.txt), and per-page Markdown files generated from the VitePress docs. ## Collaboration Share a link to co-edit in real time. No server, no account — peers connect directly via WebRTC. 1. Click the share button in the top-right panel 2. Share the generated link (`app.openpencil.dev/share/`) 3. Collaborators see your cursor, selection, and edits in real time 4. Click a peer's avatar to follow their viewport ## Why Figma is a closed platform that actively fights programmatic access. Their MCP server is read-only. [figma-use](https://github.com/dannote/figma-use) added full read/write automation via CDP — then [Figma 126 killed CDP](https://forum.figma.com/report-a-problem-6/remote-debugging-port-not-working-in-figma-desktop-126-1-2-50858). Your design files are in a proprietary binary format that only their software can fully read. Your workflows break when they decide to ship a point release. OpenPencil is the alternative: open source (MIT), reads .fig files natively, every operation is scriptable, and your data never leaves your machine. See the [roadmap](https://openpencil.dev/development/roadmap) for product direction and current Figma compatibility gaps. ## Community - **[Discord](https://discord.gg/4wXc9fuZfm)** — chat, quick questions, and showing a problem live - **[GitHub Discussions](https://github.com/open-pencil/open-pencil/discussions)** — [Q&A](https://github.com/open-pencil/open-pencil/discussions/categories/q-a) for help, [Ideas](https://github.com/open-pencil/open-pencil/discussions/categories/ideas) for feature proposals, [Show and tell](https://github.com/open-pencil/open-pencil/discussions/categories/show-and-tell) for what you built; maintainers post [Announcements](https://github.com/open-pencil/open-pencil/discussions/categories/announcements) there - **[Issues](https://github.com/open-pencil/open-pencil/issues)** — reproducible bugs; report security problems through a [private advisory](https://github.com/open-pencil/open-pencil/security/advisories/new) ## Contributing ### Setup ```sh bun install bun run dev:portless # Web editor at https://open-pencil.localhost bun run dev # Direct Vite server at http://localhost:1420 bun run tauri dev # Desktop app (requires Rust) ``` The first Portless run creates and trusts a local HTTPS certificate. Linked Git worktrees automatically receive branch-prefixed URLs such as `https://fix-ui.open-pencil.localhost`, so concurrent development servers do not compete for port 1420. Their development MCP bridges are exposed through matching sibling URLs such as `https://fix-ui.mcp.open-pencil.localhost`, with isolated TCP ports and runtime socket files. Run `bunx portless doctor` if local routing or certificate trust fails. Alternatively, open the repository in any [Dev Container](https://containers.dev/)-compatible tool. The container pins Bun, installs the workspace dependencies, and forwards the direct web editor on port 1420. Start it with `bun run dev` after the container is ready. The Dev Container supports the web editor, packages, CLI, and automated checks. Native Tauri development still requires the host setup described below because desktop windows and platform WebView dependencies are not provided in the container. ### Quality gates | Command | Description | | ------------------------- | ----------------------------------------------------------- | | `bun run check` | Full gate: lint, typecheck, package, docs, and arch checks | | `bun run test:unit:quick` | Unit tests in parallel, heavy fixtures skipped (about 15 s) | | `bun run test:unit` | Every unit test, heavy fixtures included | | `bun run test` | E2E visual regression | | `bun run format` | Code formatting | ### Project structure ``` packages/ scene-graph/ @open-pencil/scene-graph — nodes, primitives, hit testing, copy/snap/undo pen/ @open-pencil/pen — Pencil document format helpers kiwi/ @open-pencil/kiwi — Kiwi runtime and low-level .fig container parsing fig/ @open-pencil/fig — .fig archives, SceneGraph conversion, instances, metadata core/ @open-pencil/core — editor engine, renderer, layout, tools, RPC, document I/O dom-css/ @open-pencil/dom-css — HTML/CSS/Tailwind to editable design documents vue/ @open-pencil/vue — headless Vue SDK cli/ @open-pencil/cli — headless CLI mcp/ @open-pencil/mcp — MCP server (stdio + HTTP) harness/ @open-pencil/harness — companion CLI for coding-agent Harness sessions docs/ Documentation site (openpencil.dev) src/ Vue app (editor shell, AI, collaboration, document I/O) desktop/ Tauri v2 desktop app (Rust + config) skills/ Agent skill (npx skills add open-pencil/open-pencil) tools/ Repository tooling: CI, release, lint, and test infrastructure tests/ E2E, visual, and engine tests ``` ### Tech stack | Layer | Tech | | ------------- | --------------------------------------------------------------------------------- | | Rendering | Skia (CanvasKit WASM) | | Layout | Yoga WASM (flex + grid via [fork](https://github.com/open-pencil/yoga/tree/grid)) | | UI | Vue 3, Reka UI, Tailwind CSS 4 | | File format | Kiwi binary + Zstd + ZIP | | Collaboration | Trystero (WebRTC P2P) + Yjs (CRDT) | | Desktop | Tauri v2 | | AI/MCP | Vercel AI SDK (multi-provider BYOK), MCP SDK, Hono | ### Desktop builds Requires [Rust](https://rustup.rs/) and platform-specific prerequisites ([Tauri v2 guide](https://v2.tauri.app/start/prerequisites/)). ```sh bun run tauri build ``` ## Acknowledgments Thanks to [@sld0Ant](https://github.com/sld0Ant) (Anton Soldatov) for creating and maintaining the [documentation site](https://openpencil.dev). ## License OpenPencil is licensed under the [MIT License](./LICENSE). Copyright (c) 2026 Danila Poyarkov and OpenPencil contributors. --- _Source: https://npm.io/package/@open-pencil/mcp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._