← Back to Miro MCP Server

Install Miro MCP Server

Pick your client, copy the command, done.

other
Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

pip install -r requirements.txt
2

Register it in Claude Code

claude mcp add -e "MIRO_CLIENT_ID=${MIRO_CLIENT_ID}" -e "MIRO_CLIENT_SECRET=${MIRO_CLIENT_SECRET}" -e "MIRO_REDIRECT_URL=${MIRO_REDIRECT_URL}" miro-mcp -- python /path/to/miro-mcp/server.py

Replace any placeholder paths in the command with the real path on your machine.

Required:MIRO_CLIENT_IDMIRO_CLIENT_SECRETMIRO_REDIRECT_URL

Environment Variables

Set these before running Miro MCP Server.

VariableDescriptionRequired
MIRO_CLIENT_IDMiro Developer Account Client IDYes
MIRO_CLIENT_SECRETMiro Developer Account Client SecretYes
MIRO_REDIRECT_URLOAuth callback URLYes

Available Tools (8)

Once configured, Miro MCP Server gives your AI agent access to:

get_auth_urlGet the OAuth 2.0 authorization URL
exchange_auth_codeExchange authorization code for access token
code
get_boardGet information about a Miro board including metadata, name, description, and settings
board_id
create_shapeCreate a shape on a board
board_idshape_typexywidthheightfillColorborderColorborderWidthcontent
update_shapeUpdate properties of an existing shape
board_iditem_idxywidthheightfillColorborderColorborderWidthcontent
delete_shapeDelete a shape from a board
board_iditem_id
group_shapesGroup multiple shapes together
board_iditem_ids
ungroup_shapesUngroup shapes by removing them from a group/frame
board_idgroup_id

Try It Out

After setup, try these prompts with your AI agent:

→Create a new rectangle shape on board ID 123 at coordinates 100, 100 with the text 'Project Roadmap'.
→Get the details for board ID 456 to see its current metadata.
→Group the shapes with IDs 789 and 101 on board 123.
→Update the shape with ID 555 on board 123 to change its fill color to blue.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
  • MIRO_CLIENT_ID — Miro Developer Account Client ID
  • MIRO_CLIENT_SECRET — Miro Developer Account Client Secret
  • MIRO_REDIRECT_URL — OAuth callback URL

Keep this setup from going cold

Save the docs, env vars, and workflow around Miro MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup
← Miro MCP Server overview Browse other servers →