Skip to content
Back to search

inkscape-mcp

Headless Inkscape SVG automation via FastMCP — 60+ ops: create, boolean, LPE, export, text, fleet pipeline. Batch without GUI tour. For Cursor / Claude Desktop. Webapp + Tauri.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sandraschi--inkscape-mcp/badge.svg)](/listings/sandraschi--inkscape-mcp)

HTML

<a href="/listings/sandraschi--inkscape-mcp"><img src="/api/listings/sandraschi--inkscape-mcp/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.

Let your AI set it up

Do you use an AI coding assistant (Claude Code, Cursor, Codex, GitHub Copilot, ...)? Paste this into it:

Set up inkscape-mcp on this PC for me: https://github.com/sandraschi/inkscape-mcp - follow docs/AI_SETUP.md in that repository.

It checks your PC first (Inkscape, ports, disk) and installs nothing until that passes. It asks before installing Inkscape, then sets up the server and connects it to your AI app.

Or do it yourself

**Claude Desktop only:** download the `.mcpb` from [Releases](https://github.com/sandraschi/inkscape-mcp/releases/latest) and drag it onto Claude.

**Windows, with the dashboard:** `git clone https://github.com/sandraschi/inkscape-mcp`, then double-click **`start.bat`**. It installs what is missing (uv, bun, dependencies), starts the server and opens the dashboard at `http://127.0.0.1:11029`. Run it again any time: it resumes or reports that it is already running. `stop.bat` stops it. `start.bat -Check` tells you whether it will work here, without installing anything.

**Windows desktop app:** the NSIS installer from [Releases](https://github.com/sandraschi/inkscape-mcp/releases/latest).

Every method: [INSTALL.md](INSTALL.md).

> **The first `start.bat` run takes 2-4 minutes** and the window can sit quiet while Python packages > install. This is normal. Don't close it.

Something went wrong?

- **It stopped during install.** Run `start.bat` again. It continues where it stopped. - **"held by another program" on port 11028 or 11029.** Another app uses that port. Close it, then rerun. - **Export / convert does nothing.** Inkscape is missing. `winget install Inkscape.Inkscape`, then restart. - **Still stuck?** See [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md), or open an [issue](https://github.com/sandraschi/inkscape-mcp/issues) and attach `logs\start.log`.

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.

.claude-plugin/plugin.json · Manifest · 6 lines

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

  1. {
  2. "name": "inkscape-mcp",
  3. "version": "2.7.1",
  4. "description": "Inkscape MCP server for SVG and vector graphics operations",
  5. "hooks": "../hooks/hooks.json"
  6. }
README.md · README · 96 lines

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

  1. # Inkscape MCP — AI-powered vector graphics
  2. AI agents create, edit, layer, animate, and export SVG files using Inkscape. Works as an MCP server (stdio/HTTP), Claude Desktop `.mcpb` bundle, webapp dashboard, or Windows desktop app.
  3. ## Preview
  4. | Dashboard | Animation Studio | Layer Manager |
  5. |-----------|-----------------|---------------|
  6. | ![Dashboard](docs/screenshots/dashboard.png) | ![Animation Studio](docs/screenshots/animation-studio.png) | ![Layer Manager](docs/screenshots/layer-manager.png) |
  7. *Animated SVG presets render live in the browser — no Inkscape CLI needed.*
  8. ## How it runs
  9. | Mode | Inkscape | When |
  10. |------|----------|------|
  11. | **Headless (default)** | CLI via `inkscape --actions` | Batch processing, export, validation, fleet pipelines |
  12. | **Live GUI (optional)** | Open Inkscape manually + `--active-window` | Interactive editing with agent co-pilot |
  13. > **Headless by default** — no GUI needed for most operations.
  14. ## Features
  15. - Create and edit SVG files (shapes, text, paths, booleans)
  16. - Layer management — list, create, rename, hide, lock, reorder
  17. - SMIL animation — bounce, fade, slide, rotate, pulse, shake presets
  18. - Live Path Effects — bend, roughen, envelope, spiro, power stroke
  19. - Export to PNG, PDF, EPS, DXF
  20. - Fleet pipeline — hand off to GIMP, Blender, Unity, Resonite
  21. - LPEs, text operations, object inspection, hands-in control
  22. ## Install
  23. ### Let your AI set it up
  24. Do you use an AI coding assistant (Claude Code, Cursor, Codex, GitHub Copilot, ...)? Paste this into it:
  25. ```text
  26. Set up inkscape-mcp on this PC for me: https://github.com/sandraschi/inkscape-mcp - follow docs/AI_SETUP.md in that repository.
  27. ```
  28. It checks your PC first (Inkscape, ports, disk) and installs nothing until that passes. It asks before
  29. installing Inkscape, then sets up the server and connects it to your AI app.
  30. ### Or do it yourself
  31. **Claude Desktop only:** download the `.mcpb` from [Releases](https://github.com/sandraschi/inkscape-mcp/releases/latest) and drag it onto Claude.
  32. **Windows, with the dashboard:** `git clone https://github.com/sandraschi/inkscape-mcp`, then double-click
  33. **`start.bat`**. It installs what is missing (uv, bun, dependencies), starts the server and opens the dashboard
  34. at `http://127.0.0.1:11029`. Run it again any time: it resumes or reports that it is already running.
  35. `stop.bat` stops it. `start.bat -Check` tells you whether it will work here, without installing anything.
  36. **Windows desktop app:** the NSIS installer from [Releases](https://github.com/sandraschi/inkscape-mcp/releases/latest).
  37. Every method: [INSTALL.md](INSTALL.md).
  38. > **The first `start.bat` run takes 2-4 minutes** and the window can sit quiet while Python packages
  39. > install. This is normal. Don't close it.
  40. ### Something went wrong?
  41. - **It stopped during install.** Run `start.bat` again. It continues where it stopped.
  42. - **"held by another program" on port 11028 or 11029.** Another app uses that port. Close it, then rerun.
  43. - **Export / convert does nothing.** Inkscape is missing. `winget install Inkscape.Inkscape`, then restart.
  44. - **Still stuck?** See [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md), or open an
  45. [issue](https://github.com/sandraschi/inkscape-mcp/issues) and attach `logs\start.log`.
  46. ## What You Can Do
  47. > "Create a bouncing circle animation with a pink fill and 2-second duration, then export as PNG."
  48. > "List all layers in my SVG, hide the background layer, and rename the top layer to 'Hero'."
  49. > "Convert this text element to paths, then apply a roughen LPE with medium intensity."
  50. ## Documentation
  51. | Doc | Contents |
  52. |-----|----------|
  53. | [Installation](INSTALL.md) | All install methods, prerequisites |
  54. | [Onboarding](docs/ONBOARDING.md) | First-run: Inkscape requirement, sanity check, pitfalls |
  55. | [Configuration](docs/CONFIGURATION.md) | Env vars, Ollama, Tauri desktop mode |
  56. | [Tool Reference](docs/TOOLS.md) | All 17 tools, 60+ operations |
  57. | [Development](docs/DEVELOPMENT.md) | Contributing, local setup, building |
  58. | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues |
  59. ## Requirements
  60. - **Windows**, macOS, or Linux
  61. - **Inkscape 1.0+** (1.2+ recommended for Actions API)
  62. - [uv](https://docs.astral.sh/uv/) (fetches Python 3.12+ itself; `start.bat` installs uv for you)
  63. - Optional: Ollama for AI-assisted SVG generation
  64. ## License
  65. MIT — see [LICENSE.md](LICENSE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

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