Roomtone

Roomtone MCP

一个 MCP（Model Context Protocol）服务，让 AI Agent（包括 Claude Code、Claude Desktop 和任何其他 MCP 客户端）能够处理你的 Roomtone 会议笔记。

Agent 可以列出你的会议、阅读笔记内容、添加你已有的来源（YouTube 链接或粘贴的文本）、就会议内容进行对话，以及提取原始转录文本。会议录制始终在 Roomtone 应用中进行；此服务只读取并补充已有内容。

获取 API 密钥

1. 打开 Roomtone 网页应用，然后前往 Settings → API keys。
2. 创建密钥——密钥以 ak_ 开头，且只显示一次，请立即复制。

更多详情：https://roomtone.io/mcp

设置

Claude.ai（连接器，无需安装）

Claude.ai 通过 OAuth 直接连接到远程 MCP 服务——此 npm 包（stdio） 不参与其中。在 Claude.ai 中：选择 Settings → Connectors → Add custom connector，然后输入：

https://mcp.roomtone.io/mcp

Claude 会提示你登录 Roomtone 账户，并要求你批准访问权限—— 无需 API 密钥。此远程服务直接由 Roomtone 后端实现 （backend/app/mcp_server.py + backend/app/oauth_provider.py），并提供相同的 7 个工具。

Claude Code

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

任何 MCP 客户端（通用 mcpServers JSON）

{
  "mcpServers": {
    "roomtone": {
      "command": "npx",
      "args": ["-y", "roomtone-mcp"],
      "env": {
        "ROOMTONE_API_KEY": "ak_..."
      }
    }
  }
}

环境变量

变量	必需	说明
ROOMTONE_API_KEY	是	你的 Roomtone API 密钥（ak_...）。如果缺少该密钥，服务会报错并退出。
ROOMTONE_API_URL	否	API 基础 URL。默认为 https://meganotes-api.fly.dev。

工具

工具	说明
list_notebooks	列出所有会议（id、标题、emoji、sources_count、updated_at）。
get_notebook	获取一场会议及其来源（id、type、url、status）和生成的笔记。
create_notebook	使用标题和可选的 emoji 创建会议笔记。达到免费计划限额时会给出友好提示。
add_source	添加来源：youtube（通过 URL 添加，异步转录）或 text（立即存储）。
generate_note	生成或重新生成笔记内容（仅支持 summary）。在后台运行——通过 get_notebook 读取结果。
chat_with_sources	根据会议转录内容回答问题。
get_transcript	获取单个来源的原始转录文本。

开发

需要 Node.js 18+。

npm install
npm run build   # tsc → dist/
ROOMTONE_API_KEY=ak_... node dist/index.js

此服务通过 stdio 使用 MCP 通信。启动时，它会向 stderr 输出状态行，然后等待 stdin 上的 JSON-RPC 消息。

许可证

MIT