Agents

Connect an AI agent to Levee

An AI agent can work with you in Levee: Claude Code, or any other agent that supports the Model Context Protocol (MCP for short). Describe what you want in your own words, for example "Make the headline on the hero board twice as big", and watch it happen on your canvas. Connecting an agent takes one line in the terminal.

Before you start

You need Levee on your computer. The guides for Linux and macOS show how. The MCP server is part of Levee, so there is nothing extra to download. You also need an agent to connect. The steps below use Claude Code, and any other MCP host works the same way.

Your system

Register it with Claude Code

Linux

claude mcp add --scope user levee -- flatpak run --command=levee-mcp com.deichrakete.Levee//beta

Everything after the -- starts the server: Flatpak runs levee-mcp from Levee's install.

The //beta at the end is Flatpak's name for the beta. Right now it is the only version.

macOS

claude mcp add --scope user levee -- /Applications/Levee.app/Contents/MacOS/levee-mcp

Everything after the -- starts the server. levee-mcp sits inside the app, and the agent calls it by its full path.

That is the whole setup. With --scope user, Levee is available in Claude Code in every project, not only in the folder where you typed the line.

Check that it works

claude mcp list

Levee should be in the list and marked as connected. Inside a Claude Code session, /mcp shows the same.

Now try it. Open a document in Levee, start Claude Code and ask about what you have open. "What is in my Levee document?" is a good first question. While the agent works, a small robot avatar appears at the top right of Levee's header bar. It disappears ten seconds after the agent's last step.

What the agent can do

  • See which documents you have open, and read any of them.
  • Change them. It can edit the same properties you edit in the inspector, from a single colour to a whole new board, along with design tokens and components.
  • Group layers, and ungroup them again.
  • Add pictures and SVG drawings from a file on your disk or from a web address.
  • Read the comments on a cloud document, with the layer under each pin. That lets you ask it to work through the feedback.
  • Check its work. It can render a board and look at the picture instead of guessing.

Each group of changes is one step in your undo history. If you don't like the result, Ctrl+Z (⌘+Z on a Mac) takes all of it back at once.

With Levee open, or without

Usually the agent works in the running Levee. Changes appear on the canvas right away, it can refer to what you have selected, and you watch it happen. When Levee is not running, the agent can open a .levee file by its path, change it and render it. If it finds neither a running Levee nor a file, it tells you.

Other agents

You don't need Claude Code. Any agent that can start a local MCP server works, and all it needs is the command that starts it. Many hosts take it in a settings file, where the entry for Levee looks like this:

Linux

{ "command": "flatpak", "args": ["run", "--command=levee-mcp", "com.deichrakete.Levee//beta"] }

macOS

{ "command": "/Applications/Levee.app/Contents/MacOS/levee-mcp" }

There are no options or environment variables to set. The server finds the running Levee automatically.

Good to know

The server runs as you and has no password of its own. It can do to your documents what you can do, and you keep an eye on it in the Levee window. It is only connected to the agent that started it, and it accepts no connections from the network.

Disconnecting it

Disconnecting is a single line as well:

claude mcp remove levee

Levee itself stays as it is. Only the connection goes.

Something not working?

claude mcp list prints Failed to connect.
Claude Code could not start the server. Check that Levee is installed: flatpak run com.deichrakete.Levee//beta in the terminal should open it. Check that Levee is in your Applications folder under that name.
The agent says Levee is not running.
Open the document in Levee first. Or give the agent the file's path, and it works on the file directly.
The agent changed something I did not want.
Press Ctrl+Z (⌘+Z on a Mac) in Levee. That undoes everything from that request in one go.
Still stuck?
The support page has more answers. Or write to levee@deichrakete.com and tell us which agent you use and what it printed. We will help you from there.