Connect Claude Desktop

With the Automation API turned on, you can connect an AI assistant — such as Claude Desktop — to EazyDraw and work on a drawing by asking in plain language: fill in named fields, place images and PDF pages, arrange and organize layers, switch between layer configurations, and render the result so the assistant can see what it made. The assistant runs entirely on your own Mac and reaches EazyDraw only through the same private, token-protected service — nothing is sent to the network.

This page sets up Claude Desktop. The same idea works for any client that speaks the Model Context Protocol (MCP); only the place you paste the configuration changes.

1 — Turn on the Automation API

Follow the Automation API page: open EazyDraw Settings, click the Automation API button, click Generate to create an access token, then check Run. Note the Port number (52737 by default) and click Copy to put the token on the clipboard — you will paste it in step 3. Keep EazyDraw running while you use the assistant.

2 — Install the connector tool

Claude Desktop launches a small EazyDraw connector for you. It runs with uv , a lightweight Python tool runner. Install uv once by pasting this line into the Terminal application:

curl -LsSf https://astral.sh/uv/install.sh | sh

3 — Add EazyDraw to Claude Desktop

In Claude Desktop, open Settings › Developer › Edit Config (this opens the file claude_desktop_config.json in your ~/Library/Application Support/Claude folder). Add the eazydraw entry below. If the file already has an mcpServers section, add eazydraw inside it. Replace PASTE_TOKEN_HERE with the token you copied in step 1.

{
  "mcpServers": {
    "eazydraw": {
      "command": "uvx",
      "args": ["--from", "eazydraw[mcp]", "eazydraw-mcp"],
      "env": { "EAZYDRAW_TOKEN": "PASTE_TOKEN_HERE" }
    }
  }
}

If you set a Port other than 52737 in step 1, also add it to the env block as "EAZYDRAW_PORT": "<your port>".

4 — Restart and test

Quit and reopen Claude Desktop. EazyDraw appears as a connected tool source. With a drawing open in EazyDraw, ask Claude: “List my open EazyDraw drawings.” A list confirms the connection. Then try something real, for example: “Open ~/Documents/engagement.ezdjson, set the client_name field to ‘Ryan Mattson’, and render it so I can see.”

What you can ask

The assistant works by the names you give graphics in EazyDraw — mark a slot by naming a graphic, and the assistant can find and fill it. Things it can do:

Fill text — set the words in a named text box; the assistant is told whether the text fits and can resize or reflow it across linked boxes.

Place images and PDFs — insert a picture or a multi‑page PDF, or fit an image into a named placeholder slot.

Organize layers — create, reorder, show or hide layers, move a graphic between them, and apply a saved layer configuration to switch a drawing between presentations.

See the result — the assistant can render the drawing to an image at any time, so it can check its own work and show you.

Every edit respects the locks you have set in the editor and is undoable, exactly like a hand edit — so you can always step back.

Related Information

Automation API — turning the service on, the access token, and the port.

EazyDraw Automation API Reference — the complete request-and-response reference, for writing your own scripts directly.