Connect Miro to Claude Code
Read and build Miro boards, sticky notes, shapes, text, frames, connectors and tags. Add Toolspoke to Claude Code once and it can use 18 Miro actions. Your Miro credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Miro and connect it
Add Miro to a project in your Toolspoke workspace.
Access token. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- Access token
- In Miro, open Profile settings → Your apps → Create new app. Leave “Expire user authorization token” unchecked, because an expiring token stops working after 1 hour and this field cannot refresh it (the choice cannot be changed after the app is created). Under Permissions tick boards:read and boards:write, then click “Install app and get OAuth token”, pick the team, and copy the token shown. It reaches only that team's boards and lasts until the app is uninstalled.
Choose what Claude Code may do
All 18 actions start on. Switch off any of the 12 actions that change something in Miro, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Miro actions that only read, so they are safe to try first.
- List the boards this token can reach, optionally narrowed by team, project, owner or a search text
- Retrieve one board by id, its name, description, owner, team, sharing policy and link
- Retrieve one item on a board by id, with its type, content, style, position and geometry
- List the tags defined on a board, with their ids, titles and colours
What Claude Code can do in Miro
6 actions read, 9 write and 3 delete or permanently change something.
Reads
List boards
List the boards this token can reach, optionally narrowed by team, project, owner or a search text. Returns board ids, names, links and owners. Start here to find the board_id every other action takes.
Get board
Retrieve one board by id, its name, description, owner, team, sharing policy and link.
List items
List the items on a board, sticky notes, shapes, text, frames, cards, images and more, with their content, position and parent frame. Pages with a cursor.
Get item
Retrieve one item on a board by id, with its type, content, style, position and geometry.
List tags
List the tags defined on a board, with their ids, titles and colours.
List board members
List the people a board is shared with, with their names and roles.
Writes
Create board
Create an empty board. It is private to its owner by default; this action sets no sharing policy, so it shares nothing.
Copy board
Copy an existing board, with all its items, into a new board. The original is not changed.
Create sticky note
Add a sticky note to a board. Position is in board units relative to the board centre, or to the parent frame when parent_id is set.
Create shape
Add a shape to a board, optionally with text inside it, a box, circle, diamond, flowchart symbol and so on.
Create text
Add a free-standing text item to a board.
Create frame
Add a frame, a titled area that groups other items, to a board. Place items in it afterwards by passing its id as parent_id.
Create connector
Draw a line between two items already on the board, optionally with a caption on it.
Create tag
Define a new tag on a board. Attach it to cards or sticky notes with attach_tag.
Attach tag
Attach an existing tag to a card or sticky note. Up to 8 tags fit on one item.
Deletes or permanently changes
Delete board
Delete a board. Destructive: the board and every item on it go to the team's trash and are removed for everyone who had access.
Delete item
Delete one item from a board. Destructive: other collaborators lose it too, and the API offers no undo.
Share board
Share a board with people by email and give them a role. Classified destructive rather than write: it hands people, possibly outside the team, access to everything on the board, and Miro emails them an invitation that cannot be recalled.
Miro in Claude Code: questions
Does Claude Code see my Miro credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in Miro?
Yes. Each of the 18 actions can be switched off for a project. Turn off the 12 that change something and Claude Code can only read.
Will 18 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Miro action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Miro call does not run in a sandbox, so it bills nothing.
Miro in your other apps
More design toolkits for Claude Code
Try Miro in Claude Code
Free to start, and tool calls cost nothing on any plan.