Widgets MCP Server

Overview

Widgets MCP Server is an implementation of the Model Context Protocol (MCP) that integrates with Miro board widgets via REST API. It enables AI systems to interact with Miro boards by creating and managing sticky notes, as well as retrieving audit logs. This server provides tools that AI models can use to automate board operations and analyze board activity.

Use Cases

• Board Widget Management: Automate creation and deletion of sticky notes on Miro boards.
• Audit Log Analysis: Retrieve and analyze board activity logs to track changes and events.
• AI-Powered Collaboration: Use large language models to assist with board content creation and activity monitoring using the MCP protocol.

MCP Server Connection

When Claude connects to the Widgets MCP Server, the following initialization sequence occurs:

2026-01-27T14:05:30.097Z [info] [widgets-mcp-server] Server started and connected successfully
2026-01-27T14:05:30.160Z [info] [widgets-mcp-server] Message from client: {"method":"initialize","params":{"protocolVersion":"2025-06-18","clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
2026-01-27T14:05:31.496Z [info] [widgets-mcp-server] Message from server: {"jsonrpc":"2.0","id":0,"result":{"protocolVersion":"2024-11-05","serverInfo":{"name":"widgets-mcp-server","version":"1.0"}}}
2026-01-27T14:05:31.497Z [info] [widgets-mcp-server] Message from client: {"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}
2026-01-27T14:05:31.504Z [info] [widgets-mcp-server] Message from server: {
    "jsonrpc":"2.0","id":1,
    "result":{
        "tools":[
            {
                "name":"create StickyNote",
                "description":"create a sticky note widget (sticker) on a miro board",
                "inputSchema":{
                    "properties":{
                        "boardKey":{"type":"string","description":"Miro board key for a sticker creation"},
                        "text":{"type":"string","description":"The text to be displayed on the sticker"},
                        "x":{"type":"integer","format":"int32","description":"Sticker position x coordinate"},
                        "y":{"type":"integer","format":"int32","description":"Sticker position y coordinate"}
                    }
                }

            },
            {
                "name":"delete StickyNote",
                "description":"delete a sticky note widget (sticker) on a miro board",
                "inputSchema":{
                    "properties":{
                        "boardKey":{"type":"string","description":"Miro board key for a sticker creation"},
                        "stickyNoteId":{"type":"integer","format":"int64","description":"StickyNote id for deletion"}
                    }
                }
            },
            {
                "name":"get audit logs",
                "description":"retrieve audit logs for a miro board with pagination",
                "inputSchema":{
                    "properties":{
                        "boardKey":{"type":"string","description":"Miro board key for audit logs retrieval"},
                        "offset":{"type":"integer","format":"int32","description":"Offset for pagination (starting from 1)"},
                        "limit":{"type":"integer","format":"int32","description":"Limit of records to retrieve (default 20)"
                        }
                    }
                }
            }
        ]}}

This log shows:

1. Server initialization and handshake between Claude and the MCP server
2. Protocol version negotiation (client uses 2025-06-18, server responds with 2024-11-05)
3. Tool discovery - the client requests available tools and receives a list of three tools with their schemas

Installation

You can either download a precompiled JAR file from the Releases

... View full README on GitHub