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:

Code

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

Terminal

claude mcp add roomtone -e ROOMTONE_API_KEY=ak_... -- npx -y roomtone-mcp

Any MCP client (generic `mcpServers` JSON)

config.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`.

Tools

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+.