The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Roomtone listing page.
An MCP (Model Context Protocol) server that lets AI agents — Claude Code, Claude Desktop, and any other MCP client — work with your Roomtone meeting notes.
Agents can list your meetings, read a note's write-up, add a source you already have (a YouTube link or pasted text), chat with what was said, and pull the raw transcript. Recording a meeting itself always happens in the Roomtone app — this server only reads and adds to what already exists.
ak_ and is shown once, so copy it right away.More details: https://roomtone.io/mcp
Claude.ai connects directly to a remote MCP server over OAuth — this npm package (stdio) isn't involved. In Claude.ai: Settings → Connectors → Add custom connector, and enter:
Claude opens a sign-in prompt for your Roomtone account and asks you to approve access —
no API key needed. This remote server is implemented directly in the Roomtone backend
(backend/app/mcp_server.py + backend/app/oauth_provider.py), sharing the same 7 tools.
mcpServers JSON)| Variable | Required | Description |
|---|---|---|
ROOMTONE_API_KEY | Yes | Your Roomtone API key (ak_...). The server exits with an error if it is missing. |
ROOMTONE_API_URL | No | API base URL. Defaults to https://meganotes-api.fly.dev. |
| Tool | Description |
|---|---|
list_notebooks | List every meeting (id, title, emoji, sources_count, updated_at). |
get_notebook | Get one meeting with its sources (id, type, url, status) and its generated note. |
create_notebook | Start a meeting note with a title and optional emoji. Reports a friendly message if the free-plan limit is reached. |
add_source | Add a source: youtube (by URL, transcribed asynchronously) or text (stored immediately). |
generate_note | Generate or regenerate the write-up (only summary is supported). Runs in the background — read the result via get_notebook. |
chat_with_sources | Ask a question answered from the meeting's transcript. |
get_transcript | Get the raw transcript text of a single source. |
Requires Node.js 18+.
The server speaks MCP over stdio. On startup it prints a status line to stderr and then waits for JSON-RPC messages on stdin.
MIT