BusyBoard API

Read availability, find mutual free time, and list people and groups — programmatically.

Overview

The BusyBoard REST API exposes the same privacy model as the app: you get full detail for your own busy blocks, and free/busy only for everyone else — never event titles, attendees, or descriptions. The full machine-readable spec is published as OpenAPI 3.1 (/openapi.yaml).

Base URL: https://busyboard.app/api/v1
Auth: Bearer API key (bb_live_…), created in Settings → API & Integrations
API access requires a Pro plan
Rate limit: 100 requests/minute; every response carries an X-Request-Id
List endpoints are paginated (cursor/limit)

Authentication

curl https://busyboard.app/api/v1/me \
  -H "Authorization: Bearer bb_live_your_key_here"

Endpoints

Method	Path	Description
GET	/me	Current user profile, plan, and timezone
GET	/people	People you can see availability for (org members + external connections)
GET	/groups	Your groups and their members
GET	/availability	Busy blocks for one or more users in a date range
GET	/availability/summary	Per-day free/busy summary
POST	/find-time	Find mutual free slots across multiple people
GET	/calendars	Your connected calendar accounts and sync status
GET	/working-hours	Your working hours configuration

Request/response schemas, error codes, and examples are in the OpenAPI spec.

MCP server for AI agents

BusyBoard ships an MCP (Model Context Protocol) server, @busyboard/mcp, that wraps this API with five tools — get_my_schedule, get_my_availability, get_person_availability, list_my_people, and find_mutual_time — so AI assistants like Claude can check availability and find meeting times on your behalf. There is also a CLI (bb) with the same capabilities. Both authenticate with the same API keys.

Getting started

Create a BusyBoard account and connect a Google or Outlook calendar
Upgrade to Pro (pricing)
Create an API key in Settings → API & Integrations
Call GET /api/v1/me to verify