Excalidraw+
Read and draw Excalidraw+ scenes and collections through the Excalidraw+ MCP server.
Connect it with: MCP. Excalidraw+'s own documentation: https://plus.excalidraw.com/docs/mcp/getting-started.
What agents can do
Connect Excalidraw+ so the agents working your tasks can reach it. With it connected, they can:
- List the scenes in a collection and read a scene's elements and text.
- Draw an architecture or flow diagram from a task's description into a new scene.
- Update an existing scene with the changes a task made.
Before you start
- An Excalidraw+ workspace (the paid plan; the free excalidraw.com editor has no API).
- Permission in that workspace to create API keys.
- A Jaah account. Anyone can add a personal secret; an organization secret needs an Org Owner or Admin.
Connect with Excalidraw+
Jaah connects to Excalidraw+ with an access token, not with a sign-in button.
Connect with an API key
Find each value first:
- API key: In Excalidraw+, open your workspace settings and create an API key with read or full permissions (read gives agents no drawing tools). A personal key reaches your private collections but a workspace admin must allow personal keys first; a workspace key cannot reach private collections.
Then add it to Jaah:
- In Jaah, open Secrets, select New, and pick the Excalidraw+ card.
- Name the secret and choose who can use it.
- Fill in API key.
- Select Save. Jaah tests the secret straight away (see Test the connection).
Jaah encrypts what you type and never shows it again — not to you, and not to an admin.
Use your own OAuth app
Not used: Jaah connects to Excalidraw+ with an access token, not through an OAuth app.
Test the connection
Select Test on the secret. Jaah makes one read-only call to Excalidraw+ with the stored values and shows the result on the secret's page. Jaah also tests automatically when you save or reconnect.
Who can use it
Every secret has an owner, and the owner decides who can use it:
- Personal — only your own tasks can use it. This is the default.
- Organization — every task in the organization can use it. Only Org Owners and Admins can choose this.
- Attached to a project — every task on that project can use it, whoever started the task. See Attach a secret to a project.
More on owners and access: How secrets work.
Use it in an agent session
An agent asks for the secret with its credential_get tool, by the secret's path, when it needs it, and gets the values for that one call. The path is the owner's prefix and the secret's name:
org/<name>for an organization secret,projects/<project>/<name>for one attached to a project,me/<name>for your personal one.
A key connection hands the agent its fields: api_key.
Tell the agent in your task description which secret to use, for example “use the Excalidraw+ secret org/excalidraw-plus”.
Link Excalidraw+'s MCP server to a project
Excalidraw+ also runs an MCP server, which gives agents ready-made Excalidraw+ tools instead of raw API calls. A project's agents get those tools only once you link the secret to the project:
- Open the project and its MCP tab.
- Select Link, pick the Excalidraw+ secret, and confirm.
- New tasks on the project start with the Excalidraw+ tools. Tasks already running keep the tools they started with.
Jaah connects agents to the server through a local bridge, so the token never appears in the agent's configuration or its transcript. A Google Antigravity session in the terminal runtime runs without these tools; on ACP it gets them.
Manage, rotate or disconnect
Everything is on the secret's page under Secrets:
- Rotate a key: create a new key at the vendor first, then select Replace on the secret and paste it. Revoke the old key at Excalidraw+ once the test passes. Steps: Replace or delete a secret.
- Disconnect: select Delete. The stored values are destroyed and agents lose access on their next call. To end access at Excalidraw+'s side too, revoke the token at Excalidraw+.
Limitations
- The Excalidraw+ MCP server is in public beta: Excalidraw says its tools may change while it stabilizes.
- The tools an agent sees follow the key's permissions: a read-only key offers no drawing tools.
- There is no sign-in button: Excalidraw+ connects with an API key only.
- Agents can do only what the connected Excalidraw+ account allows.
Troubleshooting
Test says Excalidraw+ rejected the token (401)
The key was deleted, expired or mistyped. Create a new key in your workspace settings and select Replace on the secret.
Agents see fewer tools than expected
The key has read permissions only, or is a workspace key that cannot see private collections. Create a full-permission key of the right type, then Replace.
New tasks on the project have no Excalidraw+ tools
Link the secret on the project's MCP tab, then start a new task. Tasks already running keep the tools they started with, and an agent marked Not supported on that tab cannot load MCP servers.
Still stuck? Select Test and read the result: it names the value Excalidraw+ refused and the status it answered.
FAQ
Is this the open-source Excalidraw MCP server?
No. This card is Excalidraw+'s hosted server at api.excalidraw.com, which needs an Excalidraw+ API key. The open-source server is a different project.
What does Test do?
It opens an MCP session with Excalidraw+'s server and lists its tools, then closes the session. It reads and changes nothing in your Excalidraw+ account.
Can Jaah or an admin see the key or token?
No. Jaah stores it encrypted and never shows it again. Only the tasks allowed to use the secret receive it, at the moment they ask for it.
Can I connect more than one Excalidraw+ account?
Yes. Add one secret per account, each with its own name, and tell the agent which one to use.