Miro MCP Server

What is Miro MCP Server?

Miro MCP Server is an implementation of the Model Context Protocol (MCP) that integrates with Miro’s REST API. It enables AI systems to collaborate with users directly on Miro boards by interacting with board widgets, allowing them to build visual diagrams and perform real-time collaboration.

How to use Miro MCP Server?

Download the prebuilt JAR from the Releases page or build from source using Gradle. Then configure the server in your MCP client (e.g., Claude Desktop) by adding a mcpServers entry pointing to the JAR and passing your Miro personal access token via the --token argument. The server is invoked with java -jar.

Key features of Miro MCP Server

• Integrates with Miro REST API
• Retrieve board widgets via getWidgets
• Create sticky notes with customizable text, position, and color
• Create connectors (lines) between two widgets
• Real-time AI collaboration on Miro boards
• Simple configuration with Claude Desktop

Use cases of Miro MCP Server

• Automate collaboration on Miro boards using an AI assistant.
• Analyze the current state of a Miro board and extract information from visual layouts.
• Use large language models to assist with structured diagram creation, brainstorming, and visual task planning.

FAQ from Miro MCP Server

What is the Miro MCP Server?

It is an MCP server that gives AI agents tools to interact with Miro boards via the Miro REST API. It allows reading widgets and creating sticky notes and connectors.

How do I install and run the server?

You can either download a precompiled JAR from the GitHub Releases page or clone the repository and run ./gradlew build to produce the JAR. Then run it with Java, passing your Miro token as a command-line argument.

What tools does the server provide?

It provides three tools: getWidgets (retrieve widgets on a board), createSticky (create a sticky note), and createConnector (create a line between two widgets). Each tool requires a board key and additional parameters.

How do I get a Miro personal access token?

Follow Miro’s guide at https://developers.miro.com/docs/miro-rest-api-introduction#authorization to generate a personal access token. This token is passed to the server via the --token flag.

What are the runtime dependencies?

The server requires Java (JRE) to run the JAR file and a Miro personal access token for API authentication. It is designed to work with MCP‑compatible clients like Claude Desktop.