Miro Integration

Miro boards are often where roadmaps, planning sessions, and ideation actually happen — ahead of anything that makes it into a ticket or doc. Connect Miro and Brief reads your planning boards to keep its understanding of what your team is building toward current.

What does Brief capture?

• Planning text — frame titles, sticky notes, free-text items, and card titles/descriptions
• Board metadata — board names and last-modified times, used to prioritize which boards matter
• Nothing visual — shapes, images, connectors, and embeds are skipped; Brief only reads the words

Brief connects read-only. It cannot edit, move, or delete anything on your boards.

Why should I connect Miro to Brief?

Planning context beyond tickets and docs

Roadmap thinking often lives on a whiteboard before it's written down anywhere else. Connecting Miro means Brief's picture of your priorities isn't limited to what's already been formalized in Linear or Confluence.

One connection covers your team

Miro connects at the org level — an admin connects once, and every board Brief can see becomes available context. No per-person setup.

Automatic prioritization

Brief doesn't need you to pick boards. It automatically favors boards named like roadmaps, sprints, or timelines, and falls back to whatever's been edited most recently.

How do I set up the Miro integration?

Steps

1. Go to Integrations in Brief
2. Find Miro and click Connect
3. You'll be redirected to Miro to sign in and authorize Brief for read-only board access
4. Approve the requested permissions
5. Done! Brief starts syncing your boards — there's no board picker to configure

Because Miro is a team-level connection, only one active connection is needed per organization. If someone else already connected Miro, you'll see it as already connected rather than being asked to authorize again.

What happens after I connect?

1. Board scan — Brief lists your org's Miro boards
2. Selection — boards with roadmap/planning-style names are prioritized, then the most recently modified boards fill out the rest
3. Text extraction — Brief pulls frame titles, sticky notes, free text, and card content from the selected boards
4. Context update — that planning text feeds into Brief's understanding of your goals, priorities, and challenges, alongside your other connected sources
5. Resync — Brief periodically re-checks your boards to keep this current; there's no instant push from Miro when a board changes

Common Issues

"Nothing seems to have synced"

Cause: Your org's boards don't contain much text Brief can read — for example, they're mostly diagrams, images, or empty frames. Fix: Brief looks for frame titles, sticky notes, and card text. A board that's purely visual (arrows, shapes, screenshots) won't produce planning signal, even though it synced successfully.

"Brief connected to the wrong Miro account"

Cause: Whoever clicked Connect was signed into a personal or unrelated Miro account rather than your team's workspace. Fix: Disconnect in Brief, then reconnect while signed into your team's Miro account. Since this is a team-level connection, reconnecting replaces the org's single active connection.

"Connection shows as needing reauthorization"

Cause: Miro access tokens are short-lived; Brief refreshes them automatically, but a revoked authorization in Miro (or a deactivated Miro account) will break that refresh. Fix: Check that the Miro account that authorized Brief is still active, then reconnect from Brief's Integrations page.

"It only sees a few of our boards"

Cause: Working as designed — Brief scans your boards but only ingests a bounded, prioritized subset per sync so the process stays fast. Fix: Name your key planning boards clearly (e.g. "Q3 Roadmap", "Sprint Planning") so they're picked up first.

What's Next?

Now that Miro is connected:

• Connect Linear — Pair planning boards with the tickets they turn into
• Connect Confluence — Add written strategy docs alongside board content
• See how agents use your context — Understand where this planning signal shows up
• View Integrations — See all available integrations