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.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. 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.
  3. 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.

Try Miro in Claude Code

Free to start, and tool calls cost nothing on any plan.