Fathom MCP Server

楽しかったですが、これで一区切りです！ Fathom 公式の MCP が公開されました：https://developers.fathom.ai/mcp-docs

ただし、この MCP にカスタマイズ性の高いツールを追加する予定です。時間ができたとき、またはほかの方からのコントリビューションがあれば、引き続き保守・拡張していきます。

---

利用開始

このサーバーは、MCP Registry に io.github.agencyenterprise/fathom-mcp-server として公開されています。

Claude Desktop（ストリーミング可能な HTTP）

60 秒以内に接続できます。

https://www.fathom-mcp-server.com/mcp

1. Claude Desktop を開きます
2. 設定 > コネクター > カスタムコネクターを追加 に移動します
3. 上記の URL を貼り付けます
4. Fathom で認証します

これで完了です。Claude にミーティングについて質問できます。

組織：管理者は個人設定ではなく、組織の管理者設定からコネクターを追加する必要があります。

Perplexity Desktop およびその他の SSE クライアント

Perplexity Desktop for Mac など、従来の SSE トランスポートを使用するクライアントには、SSE エンドポイントを使用します。

https://www.fathom-mcp-server.com/sse

リモート SSE コネクターの追加方法については、お使いのクライアントのドキュメントを参照してください。

利用可能なツール

ツール	説明	ドキュメント
list_meetings	フィルター（日時、チーム、録画者など）を指定してミーティングを一覧表示します	Fathom API
search_meetings	タイトル、ホスト、参加者の情報でミーティングを検索します	MCP カスタムツール
get_transcript	録画の文字起こし全文を取得します	Fathom API
get_summary	録画の AI 生成要約を取得します	Fathom API
list_teams	アクセス可能なチームをすべて一覧表示します	Fathom API
list_team_members	チームのメンバーを一覧表示します	Fathom API

MCP カスタムツール

search_meetings

タイトル、ミーティングのタイトル、ホスト名、ホストのメールアドレス、または参加者の名前／メールアドレスで Fathom のミーティングを検索します。結果を最大 5 ページまで自動的にスキャンします。Fathom API に検索エンドポイントがないため、クライアント側でフィルタリングを行う MCP ネイティブのツールです。

リクエストとレスポンスのパラメーターの詳細については、Fathom MCP Server のドキュメントを参照してください。

Claude での使用例

「先週のミーティングを表示して」

「昨日のスタンドアップの文字起こしを取得して」

「デザインチームとのミーティングを要約して」

セキュリティ

Fathom のデータがこのサーバーに保存されたり、外部に公開されたりすることはありません。

データ	保存される？	公開される？	詳細
会議、トランスクリプト、要約	いいえ	いいえ	Fathom から取得され、Claude に直接渡されます
チームとメンバーの情報	いいえ	いいえ	Fathom から取得され、Claude に直接渡されます
OAuth トークン	はい	いいえ	保存時に暗号化（AES-256-GCM）され、ログへの記録や公開は行われません

• パススルーアーキテクチャ：このサーバーはセキュアなプロキシとして動作し、Fathom のデータは保存、キャッシュ、ログ記録されることなく、Fathom から Claude に直接渡されます
• 保存時の暗号化：保存される唯一のデータである OAuth トークンは、データベースに書き込まれる前に AES-256-GCM を使用して暗号化されます
• HTTPS のみ：Claude、このサーバー、Fathom 間のすべての通信は、転送中に暗号化されます

データの収集、使用、お客様の権利について詳しくは、プライバシーポリシーをご覧ください。

権限

この MCP サーバーは、Claude に発行するトークン用に fathom:read というカスタムスコープを定義します。これは Fathom API のスコープではなく、Fathom データへの読み取り専用アクセスを示す、この MCP サーバー固有のものです。

Fathom API 自体が提供するのは、public_api スコープによる読み取りアクセスのみです。会議やトランスクリプトの作成・編集などの書き込み操作は、Fathom API では利用できません。

制限事項

• search_meetings は、Fathom の API に検索エンドポイントがないため、クライアント側でフィルタリングを行います。会議が多い場合は、日付フィルターを指定して list_meetings を使用してください。
• 利用可能なクエリパラメーターについては、いつでも LLM に尋ねることができます。

セルフホスティング

Fathom OAuth アプリには HTTPS のリダイレクト URI が必要なため、http://localhost を使ったローカル開発はできません。テストするには、ホスティングプロバイダーにデプロイしてください。

1. ホスティングプロバイダーにデプロイする

Railway（推奨）、Render、または以下を提供する任意のプラットフォームを使用してください。

• Node.js 18 以降のランタイム
• PostgreSQL データベース
• HTTPS URL

Railway のセットアップ：

1. このリポジトリをフォーク／クローンします
2. 新しい Railway プロジェクトを作成します（フォークした Github リポジトリから直接デプロイできます）
3. プロジェクトに PostgreSQL データベースサービスを追加します
4. データベース URL をプロジェクト内のデプロイ済みリポジトリに接続し、他の環境変数を設定します

2. Fathom OAuth アプリを作成する

1. Fathom Developer Portal にアクセスします
2. 「Register your app」をクリックします（Fathom 管理者のアクセス権が必要です）
3. リダイレクト URI に https://your-app-url.railway.app/oauth/fathom/callback を設定します
4. Client ID と Client Secret を控えます

3. 環境変数を設定する（ローカルと Railway）

ホスティングプロバイダーのダッシュボードに設定してください（変更をプッシュする前に、ローカルでビルドコマンドと起動コマンドをテストするため、ローカルの .env ファイルにも設定します）。

変数	説明
DATABASE_URL	PostgreSQL 接続文字列（Railway により自動設定されます。public db url を使用してください）
BASE_URL	アプリの公開 URL（例：https://your-app.railway.app）
TOKEN_ENCRYPTION_KEY	32 バイトの 16 進数キー（openssl rand -hex 32 で生成します）
FATHOM_CLIENT_ID	手順 2 で取得
FATHOM_CLIENT_SECRET	手順 2 で取得

4. データベースを初期化する

初回デプロイ後にマイグレーションを実行します。

npm run db:migrate

または、Railway CLI を使用します。

railway run npm run db:migrate

5. Claude を接続する

デプロイした URL を、Claude Desktop のカスタムコネクターとして追加します。

https://your-app.railway.app/mcp

SSE クライアント（Perplexity Desktop など）の場合：

https://your-app.railway.app/sse

開発

npm run dev          # Start dev server with hot reload only for testing
npm run build        # Build for production
npm run start        # Run production build
npm run lint         # Check for linting errors
npm run lint:fix     # Fix linting errors
npm run typecheck    # Run TypeScript type checking
npm run ci           # Run all CI checks (lint, typecheck, test, build)
npm run format       # Format code with Prettier
npm run db:studio    # Open Drizzle Studio for database inspection
npm run db:generate  # Generate migrations from schema changes
npm run db:migrate   # Run pending migrations
npm run db:push      # Push schema directly (dev only)

ヒント：変更をプッシュする前に npm run ci を実行し、変更が GitHub Actions に合格することを確認してください。

ベータテスト

リリース前の機能には、ステージング URL を使用してください。

https://fathom-mcp-staging.up.railway.app/mcp

https://fathom-mcp-staging.up.railway.app/sse

Fathom AI の詳細

https://developers.fathom.ai/llms.txt

コントリビューション

開発環境のセットアップとガイドラインについては、CONTRIBUTING.md をご覧ください。

リリース

バージョンとリリースの手順については、RELEASING.md をご覧ください。

今後の開発計画

• トランスクリプトのベクトル化 — 大規模なトランスクリプトを LLM がより効率的に解析して理解できるよう、ベクトル化を可能にします。ユーザーデータが保存されないよう、ステートレスワーカーとして実装する予定です。
• アクションアイテムの集約 — フィルターを使って、複数の会議にまたがるアクションアイテムを集約します。「今週の未完了のアクションアイテムをすべて表示してください。」
• 会議の分析 — 会議の合計時間、開催頻度、参加者の上位などの統計を算出します。
• 発言時間の分析 — トランスクリプトを分析し、会議で最も多く発言した人を表示します。
• 会議の比較 — 2 つの会議の要約を比較して、時間の経過に伴う変化を明らかにします。
• Fathom API の変更監視 — GitHub Action で Fathom API の変更を自動検出します。定期的に API リファレンスを確認し、変更が検出された場合は issue を作成します。

これらの目標に向けたコントリビューションを歓迎します。CONTRIBUTING.md をご覧ください。

ライセンス

MIT ライセンスです。詳細は LICENSE をご覧ください。