Roomtone

Roomtone MCP

AI エージェント（Claude Code、Claude Desktop、その他すべての MCP クライアント）が、Roomtone のミーティングノートを利用できるようにする MCP（Model Context Protocol）サーバーです。

エージェントは、ミーティングの一覧表示、ノートの記録内容の閲覧、手元にあるソース（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、title、emoji、sources_count、updated_at）。
get_notebook	ソース（id、type、url、status）と生成済みノートを含む、1 件のミーティングを取得します。
create_notebook	タイトルと任意の絵文字を指定してミーティングノートを作成します。無料プランの上限に達した場合は、わかりやすいメッセージを返します。
add_source	ソースを追加します。youtube（URL を指定。文字起こしは非同期で実行）または text（すぐに保存）を指定できます。
generate_note	記録内容を生成または再生成します（summary のみ対応）。バックグラウンドで実行されます。結果は get_notebook で確認してください。
chat_with_sources	ミーティングの文字起こしをもとに回答する質問をします。
get_transcript	1 つのソースの未加工の文字起こしテキストを取得します。

開発

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