Fathom MCP Server

🚀 Fathom AI MCP Server

ClaudeをFathomの会議、会議記録、AIによる要約に接続します。

はじめる | 利用可能なツール | APIドキュメント | セルフホスティング | コントリビュート

🚀 クイックスタート

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

60秒以内で接続しましょう：

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

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

以上です。Claudeに会議に関する質問をしてみましょう。

組織: 管理者は、個人設定ではなく組織管理者設定を介してコネクタを追加する必要があります。

✨ 主な機能

利用可能なツール

カスタムMCPツール

search_meetings

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

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

Claudeでの使用例

"先週の会議を見せて"

"昨日のスタンドアップ会議の会議記録を取得して"

"デザインチームとの会議を要約して"

🔧 セキュリティ

このサーバーは、あなたのFathomデータを決して保存または公開しません。

• パススルーアーキテクチャ: このサーバーは安全なプロキシとして機能し、あなたのFathomデータはFathomからClaudeに直接流れ、保存、キャッシュ、またはログに記録されることはありません。
• 静止時の暗号化: 唯一保存されるデータ（OAuthトークン）は、データベースに書き込まれる前にAES-256-GCMを使用して暗号化されます。
• HTTPSのみ: Claude、このサーバー、およびFathom間のすべての通信は、転送中に暗号化されます。

データ収集、使用、およびあなたの権利の詳細については、プライバシーポリシー を参照してください。

🔑 権限

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

Fathom API自体は、public_api スコープを介して読み取りアクセスのみを提供します。書き込み操作（会議、会議記録などの作成/編集）は、Fathom APIでは利用できません。

⚠️ 制限事項

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

📦 インストール

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. "アプリを登録する" をクリックします（Fathom管理者アクセスが必要です）。
3. リダイレクトURIを https://your-app-url.railway.app/oauth/fathom/callback に設定します。
4. クライアントIDとクライアントシークレットをメモします。

3. 環境変数を構成する（ローカルおよびRailwayで）

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

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

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

npm run db:migrate

またはRailway CLIを介して：

railway run npm run db:migrate

5. Claudeを接続する

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

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

💻 使用例

開発

npm run dev          # テスト用のホットリロード付きで開発サーバーを起動します
npm run build        # 本番用にビルドします
npm run start        # 本番ビルドを実行します
npm run lint         # リントエラーをチェックします
npm run lint:fix     # リントエラーを修正します
npm run typecheck    # TypeScriptの型チェックを実行します
npm run ci           # すべてのCIチェック（リント、型チェック、ビルド）を実行します
npm run format       # Prettierでコードを整形します
npm run db:studio    # データベースを検査するためにDrizzle Studioを開きます
npm run db:generate  # スキーマの変更からマイグレーションを生成します
npm run db:migrate   # 保留中のマイグレーションを実行します
npm run db:push      # スキーマを直接プッシュします（開発時のみ）

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

ベータテスト

リリース前の機能を使用するには、ステージングURLを使用します：

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

Fathom AIの詳細

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

コントリビュート

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

リリース

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

将来の開発計画

• 会議記録のベクトル化 — 大規模な会議記録のベクトル化を可能にし、LLMがより効率的に解析および理解できるようにします。ユーザーデータが保持されないように、ステートレスワーカーとして実装されます。
• アクションアイテムの集約 — フィルターを使用して会議全体のアクションアイテムを集約します。「今週の未完了のアクションアイテムをすべて表示して」
• 会議分析 — 総会議時間、会議頻度、およびトップ参加者などの統計を計算します。
• 発言者時間分析 — 会議記録を分析して、会議で最も多く発言した人を表示します。
• 会議比較 — 2つの会議要約を比較して、時間の経過に伴う変更点を強調表示します。
• Fathom APIの変更履歴監視 — GitHub Actionを介してFathom APIの変更を自動検出し、変更が検出された場合に問題を作成します。

これらの目標に向けた貢献は歓迎されます。CONTRIBUTING.md を参照してください。

📄 ライセンス

MITライセンス - 詳細については LICENSE を参照してください。