MCP Miro Server

What is MCP Miro Server?

MCP Miro Server is a Model Context Protocol (MCP) server that integrates with the Miro platform, enabling AI assistants like Claude to access Miro boards and manage their content through a standardized interface.

How to use MCP Miro Server?

Install Node.js v16+ and obtain a Miro API token with required permissions (boards:read, boards:write, identity:read, identity:write, team:read, team:write). For Claude Desktop, add the server to claude_desktop_config.json with command npx -y @k-jarzyna/mcp-miro and the MIRO_ACCESS_TOKEN environment variable. The server runs on its own after configuration.

Key features of MCP Miro Server

• List, create, update, and delete Miro boards.
• Manage sticky notes, cards, frames, and shapes.
• Create and update connectors between items.
• Control board members and share boards.
• Bulk create items and export board content.
• Manage tags, groups, and mindmap nodes.

Use cases of MCP Miro Server

• An AI assistant creates a Miro board and populates it with sticky notes from a brainstorming session.
• Automatically update board item positions and properties via natural language commands.
• Manage board member permissions and sharing settings without using Miro’s UI.
• Export board data asynchronously for backup or integration with other tools.

FAQ from MCP Miro Server

What is required to run the server?

Node.js v16+, a Miro account, and a Miro API token with permissions: boards:read, boards:write, identity:read, identity:write, team:read, team:write.

How do I connect it to Claude Desktop?

Install Claude Desktop, edit the configuration file (claude_desktop_config.json), and add the server with the command npx -y @k-jarzyna/mcp-miro and the MIRO_ACCESS_TOKEN environment variable.

What permissions does the Miro token need?

The token must include boards:read, boards:write, identity:read, identity:write, team:read, and team:write.

What tools are available?

Over 80 MCP tools covering boards, items (cards, sticky notes, images, shapes, documents, embeds), connectors, tags, group management, mindmap nodes, board members, projects, exports, audit logs, and board classification.

Where can I get the Miro token?

Generate it from the Miro Developer Portal by creating an app and installing it with OAuth token using the required permissions.