Build on Roomtone
Roomtone records meetings and writes them up — the summary, the decisions, the action items, the full transcript. This page is how you get programmatic access to that data: a REST API and an MCP server, both reading the same meetings with the same key.
Quickstart
- 1
Get an API key
Sign in to the web app, go to Settings → API keys, and create one. It starts with
ak_and is shown exactly once. - 2
Call the API
Every endpoint below takes the same key as a Bearer token — no separate developer tier or approval step.
curl https://meganotes-api.fly.dev/notebooks \
-H "Authorization: Bearer ak_..."Authentication
Send your key as Authorization: Bearer ak_.... Keys are shown to you exactly once at creation and stored on our side only as a SHA-256 hash — we can't read them back. Revoke a key any time from the API keys page; revoked keys stop working immediately. There is no separate scope system yet — a key can do everything your account can do through the API.
REST API
This is the same API the iPhone app and the MCP server call — not a cut-down developer tier. Base URL: https://meganotes-api.fly.dev
| Endpoint | What it does |
|---|---|
| GET /notebooks | Every meeting in the account, newest first. |
| POST /notebooks | Start a new meeting note. |
| GET /notebooks/{id} | One meeting: its sources and its generated write-up. |
| POST /notebooks/{id}/sources | Add a source — a YouTube link or pasted text. Audio only ever comes from the app. |
| GET /notebooks/{id}/sources/{source_id}/transcript | The transcript behind one source. |
| POST /notebooks/{id}/generate | Generate or regenerate the summary write-up. |
| POST /notebooks/{id}/chat | Ask a question about one meeting, answered from its transcript. |
| GET /search?q= | Full-text search across every transcript — matches words, not meaning. |
| POST /chat | Ask a question across your whole library at once. Pro. |
| GET /action_items | Every action item across every meeting. |
| POST /action_items/{item_key}/done | Check one off. |
MCP server
Building an agent instead of a traditional integration? The same key unlocks the Roomtone MCP server — seven tools covering most of the REST API above, ready for Claude Code, Claude.ai, or any MCP client:
claude mcp add roomtone -e ROOMTONE_API_KEY=ak_... -- npx -y roomtone-mcpFull tool reference and the Claude.ai (OAuth, no API key) setup path are on the MCP page.
What's not there yet
- No webhooks — nothing calls out to you when a meeting finishes; poll
GET /notebooks/{id}instead. - No bulk export endpoint — one meeting at a time, for now.
/searchis full-text, not semantic — it matches words in the transcript, not meaning.- No published rate limit — be reasonable, and email us if a real integration needs more than that.
- Recording itself can't be started from the API or MCP — the notetaker and room recording both start from the Roomtone app.
Building something?
Email team@roomtone.io — real use cases move this list.
Get your API key →