k-jarzyna/mcp-miro
FreeMiro MCP 服务器，暴露官方 Miro SDK 中可用的所有功能。
FreeFree tier
About k-jarzyna/mcp-miro
MCP Miro Server is a Model Context Protocol (MCP) server that integrates AI assistants, such as Claude, with the Miro collaboration platform. It exposes the official Miro SDK functions as standardized MCP tools, enabling AI to perform board and item management operations. Users can list, create, update, delete, and copy boards; manage a wide variety of items including cards, sticky notes, connectors, frames, documents, text, images, and shapes; and perform operations like positioning and bulk creation. The server requires Node.js v16 or later and a Miro API access token with appropriate permissions. It is easy to set up with Claude Desktop via an npx command and environment variable configuration.
Key Features
Exposes official Miro SDK functions as MCP tools
Supports board CRUD operations: list, create, update, delete, copy
Manages various item types: app cards, cards, sticky notes, connectors, frames, documents, text, images, shapes
Items can be created, read, updated, deleted, and positioned
Enables bulk creation of items
Allows AI assistants like Claude to interact with Miro via standard MCP interface
Uses OAuth access token for secure authentication
Easy integration with Claude Desktop using npx
Pros & Cons
Pros
- Comprehensive coverage of Miro SDK functions in one MCP server
- Supports a wide variety of item types for flexible board management
- Simple setup with Claude Desktop via npx command
- Open source and free to use
- Uses standardized MCP protocol for interoperability with MCP-compatible AI clients
Cons
- Requires a Miro API access token with specific permissions (boards:read, boards:write, etc.)
- Dependent on Miro platform and SDK availability
- Not an official Miro product; maintained by a third party
- Requires Node.js v16+ environment
- Limited to Miro platform only (no other collaboration tools supported)
Best For
Automate creation and management of Miro boards via AI assistantsIntegrate Miro with AI-powered workflows for project management and brainstormingAllow AI assistants to read and update Miro board content programmaticallyBulk create items on Miro boards from AI-generated data or scriptsEnable natural language commands to interact with Miro through Claude Desktop
FAQ
What is MCP Miro Server?
MCP Miro Server is a Model Context Protocol server that enables AI assistants like Claude to access Miro boards and manage their content through a standardized interface by exposing official Miro SDK functions as MCP tools.
How do I set up MCP Miro Server with Claude Desktop?
Install Claude Desktop, then edit the configuration file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json) to add the server with command 'npx -y @k-jarzyna/mcp-miro' and environment variable 'MIRO_ACCESS_TOKEN'. Restart Claude Desktop.
What permissions are required for the Miro access token?
The token must have at least the following scopes: boards:read, boards:write, identity:read, identity:write, team:read, team:write. Microphone, screen, webcam, auditlogs, and sessions delete permissions are not required.
What tools are available?
The server provides a wide range of tools corresponding to Miro SDK functions, including board management (list, create, update, delete, copy), item management (app cards, cards, sticky notes, connectors, frames, documents, text, images, shapes) with create, read, update, delete operations, plus item positioning and bulk creation.