{"_id":"@dailyautomations/mcp-miro","_rev":"2-4805fbaedf3db2c6d41d99c20e87b03a","name":"@dailyautomations/mcp-miro","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dailyautomations/mcp-miro","version":"1.0.0","keywords":["mcp","model-context-protocol","miro","miro-api","ai-assistant","claude","integration"],"author":{"name":"Konrad Jarzyna"},"license":"Apache-2.0","_id":"@dailyautomations/mcp-miro@1.0.0","maintainers":[{"name":"dailyautomations","email":"michael@dailyautomations.com"}],"homepage":"https://github.com/k-jarzyna/mcp-miro","bugs":{"url":"https://github.com/k-jarzyna/mcp-miro/issues"},"bin":{"mcp-miro":"build/index.js"},"dist":{"shasum":"2dddce83f1520d99c67dc6a93386076aeaebc88e","tarball":"https://registry.npmjs.org/@dailyautomations/mcp-miro/-/mcp-miro-1.0.0.tgz","fileCount":113,"integrity":"sha512-7d92SZRqTXykRlm5b4ts83mu4ALs58xFynf2UQ+srhQh0Gtm9tQchMqItr6z9skhY11gMqCp5Rvx1UOlWoOhDg==","signatures":[{"sig":"MEUCIEV6ElwD7CX5wJod+drma/3QmSn7cW/gAzlYR6SvMIm0AiEA/+KRu9yNDLBcjnV3ntxPmrsEgu3LjUXJMOD13g+fo4s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":243053},"main":"build/index.js","type":"module","engines":{"node":">=16.0.0"},"gitHead":"b6de1890ca73cc43dcf54de19c8dc495e5038bcd","scripts":{"test":"echo \"No tests specified\" && exit 0","build":"tsc","clean":"rm -rf build/","prebuild":"npm run clean","postbuild":"chmod +x build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"dailyautomations","actor":{"name":"dailyautomations","type":"user","email":"michael@dailyautomations.com"},"email":"michael@dailyautomations.com"},"repository":{"url":"git+https://github.com/k-jarzyna/mcp-miro.git","type":"git"},"_npmVersion":"9.8.1","description":"Miro integration for Model Context Protocol - enables AI assistants to access and manage Miro boards","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.24.2","dotenv":"^16.4.7","@mirohq/miro-api":"^2.2.4","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.2","@types/node":"^22.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-miro_1.0.0_1752093393841_0.40298565552364485","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info."}},"time":{"created":"2025-07-09T20:36:33.665Z","modified":"2025-07-10T05:56:30.171Z","1.0.0":"2025-07-09T20:36:34.064Z"},"bugs":{"url":"https://github.com/k-jarzyna/mcp-miro/issues"},"author":{"name":"Konrad Jarzyna"},"license":"Apache-2.0","homepage":"https://github.com/k-jarzyna/mcp-miro","keywords":["mcp","model-context-protocol","miro","miro-api","ai-assistant","claude","integration"],"repository":{"url":"git+https://github.com/k-jarzyna/mcp-miro.git","type":"git"},"description":"Miro integration for Model Context Protocol - enables AI assistants to access and manage Miro boards","maintainers":[{"name":"dailyautomations","email":"michael@dailyautomations.com"}],"readme":"# MCP Miro Server\n\n[![smithery badge](https://smithery.ai/badge/@k-jarzyna/mcp-miro)](https://smithery.ai/server/@k-jarzyna/mcp-miro)\n\nModel Context Protocol (MCP) server integrating with the [Miro](https://miro.com/) platform. It enables AI assistants (like Claude) to access Miro boards and manage their content through a standardized interface.\n\n## Installation\n\n### Via NPM (Recommended)\n\n```bash\nnpm install -g @k-jarzyna/mcp-miro\n```\n\nOr use it directly with `npx`:\n\n```bash\nnpx @k-jarzyna/mcp-miro\n```\n\n## 🔗 **Essential for Workflow Diagrams: [Connector Usage Guide](./CONNECTOR_GUIDE.md)**\n\nCreating connected workflow diagrams requires understanding how to properly use connectors. The connector guide provides step-by-step examples and troubleshooting for connecting items on your Miro boards.\n\n---\n### Requirements\n\n- Node.js v16 or newer installed\n- Miro account with API token\n\n### Generate Miro Access Token\n\n1. Go to the [Miro Developer Portal](https://developers.miro.com/docs)\n2. Create a new app or use an existing one\n3. Make sure to create token with permission selected below\n4. Generate OAuth token by selecting `Install app and get OAuth token`\n\n| Permission        | Required |\n|-------------------|:--------:|\n| boards:read       |    ✅     |\n| boards:write      |    ✅     |\n| identity:read     |    ✅     |\n| identity:write    |    ✅     |\n| team:read         |    ✅     |\n| team:write        |    ✅     |\n| microphone:listen |    ❌     |\n| screen:record     |    ❌     |\n| webcam:record     |    ❌     |\n| auditlogs:read    |    ❌     |\n| sessions:delete   |    ❌     |\n\n### Connecting with Claude Desktop\n\n1. Install [Claude Desktop](https://claude.ai/download)\n2. Open or create the configuration file:\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - Linux: `~/.config/Claude/claude_desktop_config.json`\n\n3. Update it to include this server:\n\n```json\n{\n   \"mcpServers\":{\n      \"miro\":{\n         \"command\":\"npx\",\n         \"args\":[\n            \"-y\",\n            \"@k-jarzyna/mcp-miro\"\n         ],\n         \"env\":{\n            \"MIRO_ACCESS_TOKEN\":\"your_miro_access_token\"\n         }\n      }\n   }\n}\n```\n\nAlternatively, if you installed globally:\n\n```json\n{\n   \"mcpServers\":{\n      \"miro\":{\n         \"command\":\"mcp-miro\",\n         \"env\":{\n            \"MIRO_ACCESS_TOKEN\":\"your_miro_access_token\"\n         }\n      }\n   }\n}\n```\n\n4. Restart Claude Desktop\n\n---\n## Available Tools and Resources\n\n#### Tools\n| Miro SDK Function | MCP Tool | Available |\n|-------------------|----------|-----------|\n| List boards | list-boards | ✅ |\n| Create board | create-board | ✅ |\n| Update board | update-board | ✅ |\n| Delete board | delete-board | ✅ |\n| Copy board | copy-board | ✅ |\n| Get specific board | get-specific-board | ✅ |\n| Get items on board | get-items-on-board | ✅ |\n| Get specific item | get-specific-item | ✅ |\n| Update item position | update-item-position | ✅ |\n| Delete item | delete-item | ✅ |\n| Create app card item | create-app-card-item | ✅ |\n| Get app card item | get-app-card-item | ✅ |\n| Update app card item | update-app-card-item | ✅ |\n| Delete app card item | delete-app-card-item | ✅ |\n| Create card item | create-card-item | ✅ |\n| Get card item | get-card-item | ✅ |\n| Update card item | update-card-item | ✅ |\n| Delete card item | delete-card-item | ✅ |\n| Create connector | create-connector | ✅ |\n| Get connectors | get-connectors | ✅ |\n| Get specific connector | get-specific-connector | ✅ |\n| Update connector | update-connector | ✅ |\n| Delete connector | delete-connector | ✅ |\n| Create sticky note item | create-sticky-note-item | ✅ |\n| Get sticky note item | get-sticky-note-item | ✅ |\n| Update sticky note item | update-sticky-note-item | ✅ |\n| Delete sticky note item | delete-sticky-note-item | ✅ |\n| Create frame | create-frame | ✅ |\n| Get frame item | get-frame-item | ✅ |\n| Update frame item | update-frame-item | ✅ |\n| Delete frame item | delete-frame-item | ✅ |\n| Create document item | create-document-item | ✅ |\n| Get document item | get-document-item | ✅ |\n| Update document item | update-document-item | ✅ |\n| Delete document item | delete-document-item | ✅ |\n| Create text item | create-text-item | ✅ |\n| Get text item | get-text-item | ✅ |\n| Update text item | update-text-item | ✅ |\n| Delete text item | delete-text-item | ✅ |\n| Create items in bulk | create-items-in-bulk | ✅ |\n| Create image item using URL | create-image-item-using-url | ✅ |\n| Create image item using file | create-image-item-using-file | ✅ |\n| Get image item | get-image-item | ✅ |\n| Update image item | update-image-item | ✅ |\n| Update image item using file | update-image-item-using-file | ✅ |\n| Delete image item | delete-image-item | ✅ |\n| Create shape item | create-shape-item | ✅ |\n| Get shape item | get-shape-item | ✅ |\n| Update shape item | update-shape-item | ✅ |\n| Delete shape item | delete-shape-item | ✅ |\n| Create embed item | create-embed-item | ✅ |\n| Get embed item | get-embed-item | ✅ |\n| Update embed item | update-embed-item | ✅ |\n| Delete embed item | delete-embed-item | ✅ |\n| Create tag | create-tag | ✅ |\n| Get tag | get-tag | ✅ |\n| Get all tags | get-all-tags | ✅ |\n| Update tag | update-tag | ✅ |\n| Delete tag | delete-tag | ✅ |\n| Attach tag | attach-tag | ✅ |\n| Detach tag | detach-tag | ✅ |\n| Get item tags | get-item-tags | ✅ |\n| Get all board members | get-all-board-members | ✅ |\n| Get specific board member | get-specific-board-member | ✅ |\n| Remove board member | remove-board-member | ✅ |\n| Share board | share-board | ✅ |\n| Update board member | update-board-member | ✅ |\n| Create group | create-group | ✅ |\n| Get all groups | get-all-groups | ✅ |\n| Get group | get-group | ✅ |\n| Get group items | get-group-items | ✅ |\n| Update group | update-group | ✅ |\n| Ungroup items | ungroup-items | ✅ |\n| Delete group | delete-group | ✅ |\n| Create items in bulk using file | create-items-in-bulk-using-file | ✅ |\n| Create mindmap node | create-mindmap-node | ✅ |\n| Get mindmap node | get-mindmap-node | ✅ |\n| Get mindmap nodes | get-mindmap-nodes | ✅ |\n| Delete mindmap node | delete-mindmap-node | ✅ |\n| Add project member | add-project-member | ✅ |\n| Create board export job | create-board-export-job | ✅ |\n| Get all cases | get-all-cases | ✅ |\n| Get all legal holds | get-all-legal-holds | ✅ |\n| Get audit logs | get-audit-logs | ✅ |\n| Get board classification | get-board-classification | ✅ |\n| Get board content logs | get-board-content-logs | ✅ |\n| Get board export job results | get-board-export-job-results | ✅ |\n| Get board export job status | get-board-export-job-status | ✅ |\n| Get case | get-case | ✅ |\n| Get legal hold | get-legal-hold | ✅ |\n| Get legal hold content items | get-legal-hold-content-items | ✅ |\n| Get organization info | get-organization-info | ✅ |\n| Get organization member | get-organization-member | ✅ |\n| Get organization members | get-organization-members | ✅ |\n| Get project member | get-project-member | ✅ |\n| Remove project member | remove-project-member | ✅ |\n| Update board classification | update-board-classification | ✅ |\n\n\n---\n## Local Development\n\n1. Install dependencies:\n\n```bash\nnpm install\n```\n\n2. Create a `.env` file based on the template:\n\n```bash\ncp .env.template .env\n```\n\n3. Edit the `.env` file and add your Miro access token\n\n4. Build the server:\n\n```bash\nnpm run build\n```\n\n### Running the Server\n\nTo run the server:\n\n```bash\nnode build/index.js\n```\n\n---\n## License\n\nApache License 2.0\n\nThis project is licensed under the Apache License, Version 2.0. See the [LICENSE](LICENSE) file for details.\n","readmeFilename":"README.md"}