carmelosantana/coqui-toolkit-miro

Miro REST API toolkit for Coqui — authenticate, create and manage boards, items, collaborators, tags, frames, groups, webhooks, and board activity summaries.

v0.1.0 2026-04-19 15:24 UTC

Requires

• php: ^8.4
• symfony/http-client: ^7.0

Requires (Dev)

• carmelosantana/php-agents: ^0.7
• pestphp/pest: ^3.0
• phpstan/phpstan: ^2.0

MIT

• Carmelo Santana

• toolkit
• collaboration
• boards
• php-agents
• coqui
• miro
• whiteboard

README

Miro REST API toolkit for Coqui.

This package gives Coqui a REST-first integration for managing Miro boards through natural-language tool calls. It supports direct token authentication and OAuth, board CRUD, supported item CRUD, collaborator management, tags, frames, grouping, webhook registration, and board activity summaries.

Package

• Package: carmelosantana/coqui-toolkit-miro
• Namespace: CarmeloSantana\CoquiToolkitMiro\
• PHP: ^8.4

Installation

composer require carmelosantana/coqui-toolkit-miro

Authentication

The toolkit automatically prefers a direct token when one is configured.

Supported environment variables:

• MIRO_ACCESS_TOKEN
• MIRO_API_TOKEN
• MIRO_CLIENT_ID
• MIRO_CLIENT_SECRET
• MIRO_DEFAULT_TEAM_ID
• MIRO_WEBHOOKS_BASE_PATH

Direct token mode

export MIRO_ACCESS_TOKEN="your-token"

OAuth mode

export MIRO_CLIENT_ID="your-client-id"
export MIRO_CLIENT_SECRET="your-client-secret"

Then inside Coqui:

miro_auth(action: "status")
miro_auth(action: "login")

Tools

• miro_auth
• miro_board
• miro_item
• miro_frame
• miro_group
• miro_tag
• miro_collaborator
• miro_webhook
• miro_activity

Supported item types

• sticky_note
• card
• shape
• text
• embed
• frame
• connector

Current scope

This first implementation pass is intentionally REST-first and avoids a runtime MCP dependency.

Included:

• board CRUD
• supported item CRUD
• frame management
• grouping flows
• tag management
• collaborator management
• webhook CRUD
• read-only board activity summaries

Not included yet:

• comment CRUD
• hosted webhook listener infrastructure
• image/document upload helpers
• runtime MCP fallback execution
• enterprise org and project administration

Development

composer install
composer test
composer analyse
```# Coqui Toolkit Miro

Miro REST API toolkit for Coqui.

This package gives Coqui a REST-first integration for managing Miro boards through natural-language tool calls. It supports direct token authentication and OAuth, board CRUD, supported item CRUD, collaborator management, tags, frames, grouping, webhook registration, and board activity summaries.

## Package

- Package: `carmelosantana/coqui-toolkit-miro`
- Namespace: `CarmeloSantana\CoquiToolkitMiro\`
- PHP: `^8.4`

## Installation

```bash
composer require carmelosantana/coqui-toolkit-miro

Authentication

The toolkit automatically prefers a direct token when one is configured.

Supported environment variables:

• MIRO_ACCESS_TOKEN
• MIRO_API_TOKEN
• MIRO_CLIENT_ID
• MIRO_CLIENT_SECRET
• MIRO_DEFAULT_TEAM_ID
• MIRO_WEBHOOKS_BASE_PATH

Direct token mode

export MIRO_ACCESS_TOKEN="your-token"

OAuth mode

export MIRO_CLIENT_ID="your-client-id"
export MIRO_CLIENT_SECRET="your-client-secret"

Then inside Coqui:

miro_auth(action: "status")
miro_auth(action: "login")

Tools

• miro_auth
• miro_board
• miro_item
• miro_frame
• miro_group
• miro_tag
• miro_collaborator
• miro_webhook
• miro_activity

Supported item types

• sticky_note
• card
• shape
• text
• embed
• frame
• connector

Current scope

This first implementation pass is intentionally REST-first and avoids a runtime MCP dependency.

Included:

• board CRUD
• supported item CRUD
• frame management
• grouping flows
• tag management
• collaborator management
• webhook CRUD
• read-only board activity summaries

Not included yet:

• comment CRUD
• hosted webhook listener infrastructure
• image/document upload helpers
• runtime MCP fallback execution
• enterprise org and project administration

Development

composer install
composer test
composer analyse