Inkscape (inksmcp) MCP server

inksmcp

An MCP server that lets AI assistants create, edit and export vector graphics with Inkscape.

<!-- mcp-name: io.github.bhanutpt/inksmcp -->

Describe a poster, a diagram, a chart or a comic page to your assistant, and it builds a real SVG document in Inkscape: measured, laid out and exported to PNG or PDF. It can also open drawings made elsewhere and change them.

Made by Claude through inksmcp during field tests, in 13 to 41 tool calls each. The SVG was never edited by hand. The floor plan and the periodic table used a short script to prepare their data.

Why inksmcp

Asking a model to write SVG by hand works for an icon, but it breaks down on real layouts. The model can't measure text, keeps redoing coordinate arithmetic, and can't see what it drew. inksmcp takes that work off the model:

document's own units.

• Measured, not guessed. Bounding boxes come from Inkscape itself, text included, in the

caption below a title's real glyphs. fit_to sizes a box around its content. connect draws arrows that stay attached when things move.

• Relationships instead of coordinates. align and layout arrange things. place keeps a

character poses). split divides a page into panels or cells. Large data comes from JSON or CSV files, so it doesn't pass through the conversation.

• Data-driven. repeat stamps a template per data row (cards, timelines, legends, table rows,

locates elements by colour, type, text or symbol. Symbols can be placed from icon libraries.

• Works on existing files. It opens .svg/.svgz drawings from other tools. inspect find

and render_preview shows the agent what it drew.

• Safe and checkable. Every tool is all-or-nothing. Editing responses warn about overlapping text,

Inkscape.

• Real output. PNG, PDF (optionally with text as paths), plain SVG, EPS, EMF and more, rendered by

Quick start

1. Install Inkscape 1.x and uv.
2. Add the server to your MCP client. For Claude Code:

claude mcp add --scope user inkscape -- uvx inksmcp

For Claude Desktop, Cursor and others:

{ "mcpServers": { "inkscape": { "command": "uvx", "args": ["inksmcp"] } } }

garden, show me a preview, then export a PDF."*

1. Ask: *"Using the inkscape tools, make an A5 flyer for a book swap on Saturday at 10:00 in the library

Details for each OS and client, and troubleshooting, are in getting started.

Tools

Shortened. The full README is on GitHub.