miro

What This Skill Does

The Miro skill allows you to programmatically manage collaborative whiteboards on the Miro platform. Leveraging the Miro API, this skill enables you to create, update, and interact with boards, sticky notes, and shapes without manual intervention. You can generate new boards for project planning, brainstorm sessions, or any collaborative task, and populate them with essential elements like sticky notes to capture ideas and shapes to visually organize information. This skill is ideal for automating the setup of collaborative spaces, ensuring consistency, and integrating whiteboard functionalities into larger workflows.

Installation

To install the Miro skill, use the following command:

clawhub install openclaw/skills/skills/mrgoodb/miro

Before using the skill, ensure you have set up your Miro access token in your environment:

export MIRO_ACCESS_TOKEN="xxxxxxxxxx"

Replace xxxxxxxxxx with your actual Miro API access token, which can be generated from your Miro developer dashboard.

Use Cases

• Automated Board Creation: Generate new Miro boards for specific projects, events, or teams with pre-defined structures or templates.
• Dynamic Content Population: Programmatically add sticky notes with meeting minutes, action items, or brainstormed ideas directly to a board.
• Visual Information Organization: Create shapes like rectangles, circles, or other geometric figures to visually represent tasks, stages, or concepts on a whiteboard.
• Integration with Other Tools: Combine Miro's visual collaboration with other tools by having data from external systems automatically update Miro boards.
• Onboarding & Setup: Automate the creation and initial setup of Miro boards for new team members or projects, ensuring everyone starts with a consistent workspace.

Example Prompts

• "Create a new Miro board for our Q3 marketing campaign planning and add a sticky note saying 'Develop social media strategy'."
• "On the board named 'Project Alpha Retrospective', add a yellow sticky note with the content 'Improve deployment process' at position X=100, Y=200."
• "Generate a new rectangle shape on my 'User Feedback' board with the content 'Bug Report' and set its dimensions to 150x80."

Tips & Limitations

• API Token Security: Treat your MIRO_ACCESS_TOKEN as sensitive information. Do not share it publicly or commit it directly into your code repositories. Use environment variables for secure management.
• Rate Limits: Be mindful of Miro API rate limits. Excessive requests in a short period might lead to temporary blocking. Implement appropriate error handling and retry mechanisms if necessary.
• Item Positioning: When creating items like sticky notes or shapes, specify the position (x, y coordinates) and optionally geometry (width, height) to control their placement and size on the board. If not provided, items may appear at default locations.
• Board ID: Most operations require a {board_id}. You can obtain this ID from the URL of your Miro board or by listing all boards first.
• Supported Shapes: The API supports various shapes for sticky notes and dedicated shapes. Refer to the Miro API documentation for a full list of supported shape types.
• Error Handling: Implement robust error handling to manage API errors, invalid requests, or network issues gracefully.