---

name: miro description: Miro REST API integration for board management, diagram creation, and whiteboard automation. Create and manage boards, add sticky notes, shapes, and connectors, export boards as images/PDFs, and integrate with AI workflows for automated diagram generation from PRDs, code, or text descriptions. homepage: https://github.com/chrisagiddings/openclaw-miro-skill metadata: {"openclaw":{"emoji":"🎨","requires":{"env":["MIRO_ACCESS_TOKEN"],"bins":["curl","jq"]},"primaryEnv":"MIRO_ACCESS_TOKEN","disable-model-invocation":true,"capabilities":["board-management","diagram-creation","whiteboard-automation","export","destructive-operations"],"credentials":{"type":"env","variables":[{"name":"MIRO_ACCESS_TOKEN","description":"Miro OAuth access token","required":true},{"name":"MIRO_CLIENT_ID","description":"Miro OAuth client ID (optional, for OAuth flow)","required":false},{"name":"MIRO_CLIENT_SECRET","description":"Miro OAuth client secret (optional, for OAuth flow)","required":false}]}}}

Miro Skill

Interact with Miro boards via REST API. Create boards, add content, generate diagrams, and automate whiteboard workflows.

⚠️ Security Warning

This skill can perform DESTRUCTIVE operations on your Miro workspace:

• Board Management: Create, update, and delete boards
• Content Creation: Add sticky notes, shapes, connectors, images, text
• Item Modification: Update positions, colors, content
• Board Deletion: Permanently delete boards
• Permissions: Manage board sharing and access

Operation Types:

Read-Only Operations (✅ Safe):

• List boards
• Get board details
• List board items
• Export boards as images/PDFs
• All GET requests

Destructive Operations (⚠️ Modify or delete data):

• Create/update/delete boards
• Create/update/delete board items
• Modify permissions
• All POST, PUT, PATCH, DELETE requests

Best Practices:

1. Test on non-critical boards first
2. Review API calls before running - Check what the command will do
3. No undo for deletions - Deleted boards cannot be recovered
4. Token security - Store access tokens securely (1Password CLI recommended)
5. Rate limits - Miro enforces rate limits; respect them

Setup

1. Create a Miro App

1. Go to https://miro.com/app/settings/user-profile/apps
2. Click "Create new app"
3. Name: "OpenClaw Integration"
4. Add redirect URI: http://localhost:8080/callback (for OAuth flow)
5. Copy your Client ID and Client Secret
6. Create an access token for testing (Settings → Your access token)

2. Configure Environment Variables

Option A: Quick Start (Access Token)

# Add to your shell profile (~/.zshrc, ~/.bashrc)
export MIRO_ACCESS_TOKEN="your-access-token-here"

Option B: Full OAuth Flow (For Production)

export MIRO_CLIENT_ID="your-client-id"
export MIRO_CLIENT_SECRET="your-client-secret"
export MIRO_ACCESS_TOKEN="your-access-token"  # Generated via OAuth

Option C: 1Password CLI (Most Secure)

# Store token in 1Password
op item create --category=API_CREDENTIAL \
  --title="Miro Access Token" \
  access_token[password]="your-token-here"

# Use in commands
export MIRO_ACCESS_TOKEN=$(op read "op://Private/Miro Access Token/access_token")

3. Test Connection

curl -H "Authorization: Bearer $MIRO_ACCESS_TOKEN" \
  https://api.miro.com/v2/boards | jq '.'

Usage

All scripts are located in the scripts/ directory.

List Boards

./scripts/boards.sh list
./scripts/boards.sh list --limit 50
./scripts/boards.sh list --query "Sprint Planning"

Create Board

./scripts/boards.sh create "Project Roadmap"
./scripts/boards.sh create "Team Retro" --description "Q1 2026 Retrospective"

Get Board Details

./scripts/boards.sh get <board-id>

Create Sticky Notes

./scripts/items.sh sticky-note <board-id> "User feedback" --color yellow
./scripts/items.sh sticky-note <board-id> "Bug fix" --color red --x 100 --y 200

Create Shapes

./scripts/items.sh shape <board-id> "Process Step" --shape rectangle --x 0 --y 0
./scripts/items.sh shape <board-id> "Decision" --shape diamond --color blue

Create Connectors

./scripts/items.sh connector <board-id> <start-item-id> <end-item-id>
./scripts/items.sh connector <board-id> <start-id> <end-id> --style curved --color red

List Board Items

./scripts/items.sh list <board-id>
./scripts/items.sh list <board-id> --type sticky_note

Export Board

./scripts/export.sh png <board-id> output.png
./scripts/export.sh pdf <board-id> output.pdf

AI Workflows

Generate Board from PRD

# Read PRD, generate Miro board structure
./scripts/ai-workflows.sh generate-from-prd document.md "Product Roadmap Board"

Create Flowchart from Code

# Analyze code, create visual flowchart
./scripts/ai-workflows.sh flowchart-from-code src/auth.js "Auth Flow"

Visualize User Journey

# Create user journey map from description
./scripts/ai-workflows.sh user-journey user-stories.md "Onboarding Journey"

Common Patterns

Daily Standup Board

#!/bin/bash
BOARD_ID=$(./scripts/boards.sh create "Daily Standup - $(date +%Y-%m-%d)" | jq -r '.id')

# Add columns
./scripts/items.sh sticky-note "$BOARD_ID" "Yesterday" --color yellow --x -400 --y 0
./scripts/items.sh sticky-note "$BOARD_ID" "Today" --color green --x 0 --y 0
./scripts/items.sh sticky-note "$BOARD_ID" "Blockers" --color red --x 400 --y 0

echo "Standup board created: https://miro.com/app/board/$BOARD_ID"

Retrospective Template

#!/bin/bash
BOARD_ID=$(./scripts/boards.sh create "Team Retro - Sprint 23" | jq -r '.id')

# Add retro sections
./scripts/items.sh sticky-note "$BOARD_ID" "What went well?" --color green --x -300 --y -200
./scripts/items.sh sticky-note "$BOARD_ID" "What didn't go well?" --color red --x 0 --y -200
./scripts/items.sh sticky-note "$BOARD_ID" "Action items" --color yellow --x 300 --y -200

API Reference

Base URL: https://api.miro.com/v2

Authentication: Bearer token in Authorization header

Rate Limits:

• 100 requests per minute per access token
• 1000 requests per hour per access token

Common Endpoints:

| Endpoint | Method | Description | |----------|--------|-------------| | /boards | GET | List boards | | /boards | POST | Create board | | /boards/{id} | GET | Get board details | | /boards/{id} | DELETE | Delete board | | /boards/{id}/items | GET | List board items | | /boards/{id}/sticky_notes | POST | Create sticky note | | /boards/{id}/shapes | POST | Create shape | | /boards/{id}/connectors | POST | Create connector | | /boards/{id}/export | POST | Export board |

Resources

• API Documentation: https://developers.miro.com/docs/rest-api-reference
• OAuth Guide: https://developers.miro.com/docs/getting-started-with-oauth
• GitHub Repo: https://github.com/chrisagiddings/openclaw-miro-skill
• Report Issues: https://github.com/chrisagiddings/openclaw-miro-skill/issues

Tips

• Rate Limits: Add delays between bulk operations (sleep 0.1)
• Board IDs: Always stored as strings, not numbers
• Coordinates: Center of board is (0, 0); X increases right, Y increases down
• Colors: Use standard names (red, yellow, green, blue, etc.)
• Testing: Create a "Sandbox" board for testing before production use

Error Handling

401 Unauthorized:

# Token expired or invalid - regenerate token
export MIRO_ACCESS_TOKEN="new-token-here"

429 Rate Limited:

# Wait before retrying
sleep 60

404 Not Found:

# Board or item doesn't exist - check IDs
./scripts/boards.sh list  # Verify board exists

Security Notes

• Never commit tokens to version control
• Use environment variables for all credentials
• Rotate tokens regularly (every 90 days recommended)
• Use 1Password CLI for production deployments
• Audit token permissions - only grant needed scopes
• Monitor API usage via Miro dashboard

License

MIT - see LICENSE