Roomtone MCP
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.
Getting an API key
- Open the Roomtone web app and go to Settings → API keys.
- Create a key — it starts with
ak_ and is shown once, so copy it right away.
More details: https://roomtone.io/mcp
Setup
Claude.ai (Connectors, no install)
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:
https://mcp.roomtone.io/mcp
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.
Claude Code
claude mcp add roomtone -e ROOMTONE_API_KEY=ak_... -- npx -y roomtone-mcp
Any MCP client (generic mcpServers JSON)
{
"mcpServers": {
"roomtone": {
"command": "npx",
"args": ["-y", "roomtone-mcp"],
"env": {
"ROOMTONE_API_KEY": "ak_..."
}
}
}
}
Environment variables
| 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. |
Development
Requires Node.js 18+.
npm install
npm run build
ROOMTONE_API_KEY=ak_... node dist/index.js
The server speaks MCP over stdio. On startup it prints a status line to stderr and then waits for JSON-RPC messages on stdin.
License
MIT