miro-cli

What This Skill Does

The Miro CLI skill acts as a command-line interface wrapper for the mirocli tool, allowing you to manage and interact with your Miro boards, teams, and organization directly from your terminal. By bridging OpenClaw with your Miro account, this skill enables efficient, programmatic access to platform resources. It is designed for developers, system administrators, and power users who need to automate board exports, audit team memberships, or extract organizational metadata without navigating the web UI. The tool utilizes the official Miro Platform API while delegating credential management to your system's secure keyring.

Installation

To begin, ensure you have Node.js and npm installed on your machine. Install the core CLI tool globally using the command: npm install -g mirocli. You should also install jq for advanced JSON parsing and column for improved terminal output legibility. Once installed, initialize the tool using the appropriate setup command to input your Client ID, Client Secret, and Organization ID. These credentials are stored locally in your system's secure credential manager, ensuring that OpenClaw does not handle or cache your sensitive tokens directly. After configuration, run clawhub install openclaw/skills/skills/bigbubbaagent-bot/miro-cli to enable the skill within your agent environment.

Use Cases

This skill is ideal for bulk board management, such as generating automated reports of board activity or performing batch exports of boards as PDFs. It is heavily utilized by teams needing to audit enterprise member lists, verify team settings, or script clean-up processes for older boards. DevOps engineers often leverage this tool to pipe board metadata into CI/CD workflows, allowing for real-time tracking of project planning status across an entire organization.

Example Prompts

1. "Miro CLI, list all boards in my current team and format the output as a table."
2. "Search for boards containing 'Quarterly Planning' and export the first result as a PDF to my current directory."
3. "Show me the recent activity logs for the 'Engineering' team using the Miro CLI."

Tips & Limitations

Note that this is a community-maintained tool; always verify the source code before handling highly sensitive production data. The skill currently supports read-only access and specific export operations; it does not support full-scale board creation or modification. Ensure your terminal environment has active network access to the Miro API endpoints and that your OAuth app has the necessary scopes configured for the actions you intend to perform.