Open-source project

Miro Workflows

Workflow operations dashboard that moves board-shaped work into explicit SQLite schemas with MCP tooling and optional live sync back to Miro.

Project details

Classification: Open-source project
Repository: Alexi5000/miro-workflows
Language: TypeScript
License: MIT
Status: Active development
Tests: 3 test notes
Last verified: 2026-08-01

What it is

I use Miro Workflows to show how board content can be modeled as tables and relations, with an MCP interface and optional synchronization. The repository includes schemas and example payloads. It works with Miro, not Airtable; it illustrates some data-modeling choices that also matter when reviewing an Airtable system.

Architecture

SQLite schemas model boards, items, and relations explicitly instead of treating the source tool as the schema.
Custom MCP server (miro-custom-mcp) exposes the same operations to agents that the dashboard uses.
Separate API, MCP, and web images so the sync worker scales independently of the UI.
Optional live sync: the system is useful read-only before any write-back is enabled.

Tests and gates

GitHub Actions ci workflow plus a tests directory.
Example payloads and notebooks are checked in for reproducing sync behaviour.
RELEASING.md and CHANGELOG.md track versioned behaviour changes.

Limits

Sync is scoped to the Miro object model, not a general no-code migration tool.
SQLite is the reference store. Choosing another database requires a separate review of workload and access requirements.
This project works with Miro and does not include an Airtable connector.