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.
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 listprints Failed to connect.-
Claude Code could not start the server.
Check that Levee is installed:
flatpak run com.deichrakete.Levee//betain 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.