Fathom

@mindstone/mcp-server-fathom

Fathom AI を使って、会議の一覧表示や検索、詳細の表示、文字起こしの閲覧、チームの管理を行います。

ローカル専用の Fathom MCP です。公式サーバーではありません。Fathom が公式サーバーを公開する前に構築したもので、トークンはディスク上に保存され、各リリースでは独自のセキュリティレビューを実施しています。

ステータス

• バージョン： 0.3.0 · npm
• 認証： API キー（FATHOM_API_KEY）
• ツール： 12（会議、文字起こし、アクションアイテム、録音、チーム、ウェブフック）
• 対象： cloud-api
• 機械可読： STATUS.json

開発の背景

2026 年初頭にこれを構築した時点では、Fathom は公式 MCP サーバーを公開しておらず、当時利用できたコミュニティ製の選択肢は機能が限られ、メンテナンスもされていませんでした。会議の一覧表示はできても、会議メモのワークフローに必要なチームや文字起こしのデータには対応していませんでした。そこで、リポジトリ内の他の部分と同じ認証情報の取り扱い、タイムアウト、安全性を確保する仕組みを適用し、あらゆる MCP ホストから Fathom の文字起こしや会議の詳細を取得できるよう、独自に構築しました。その後、Fathom は公式 MCP サーバーをリリースしましたが、このサーバーはユーザーのマシン上でローカルに動作し、各リリース前に独自のセキュリティレビューを実施するため、引き続きメンテナンスしています。

インタラクション例

「Fathom から昨日の第 3 四半期計画会議を取得して、文字起こしからアクションアイテムを一覧表示してください。」

ホストが呼び出すツール：

1. list_fathom_meetings — 日付範囲で絞り込み、会議を見つけて ID を返します。
2. get_fathom_meeting — その会議 ID の詳細、要約、アクションアイテムを取得します。（会議をまたいだ表示（「今週の顧客との通話で、未完了のアクションアイテムは何ですか？」など）の場合、ホストは get_fathom_action_items を直接呼び出します。）

応答（一部抜粋）：

{
  "meeting": {
    "recording_id": 123456789,
    "title": "<untrusted-content source=\"fathom:meeting:title\">Q3 planning</untrusted-content>",
    "scheduled_start_time": "2026-05-18T15:00:00Z",
    "action_items": [
      {
        "description": "<untrusted-content source=\"fathom:meeting:action_item\">Lock the JD by Friday</untrusted-content>",
        "completed": false,
        "assignee": { "name": "<untrusted-content source=\"fathom:meeting:assignee_name\">Bob</untrusted-content>", "email": "[email protected]" }
      }
    ]
  }
}

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから FATHOM_API_KEY の入力を求められます。

{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-fathom"
      ],
      "env": {
        "FATHOM_API_KEY": ""
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/fathom
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-fathom

ローカル

node dist/index.js

設定

環境変数

• FATHOM_API_KEY — Fathom API キー（fathom.video の設定から取得）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と下位互換性のあるエイリアス

ホスト設定例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-fathom"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル開発（npm での公開は不要）

{
  "mcpServers": {
    "Fathom": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/fathom/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

ツール（12）

設定

• configure_fathom_api_key — Fathom API キーを設定します

ミーティング

• list_fathom_meetings — サーバー側でフィルタリングしてミーティングを一覧表示します（任意でアクションアイテムを含められます）
• get_fathom_meeting — 要約とアクションアイテムを含む、単一のミーティングの詳細を取得します
• get_fathom_transcript — ミーティングの文字起こしを取得します
• get_fathom_meeting_participants — ミーティングの参加者を一覧表示します
• get_fathom_action_items — ミーティング全体のアクションアイテムを一覧表示します（デフォルトでは未完了の項目）

録音

• request_fathom_recording_download — ダウンロード可能な録音ファイルの生成を非同期で開始します
• get_fathom_recording_download_status — ダウンロードの有効期間が短い署名付き URL を取得するために、状態をポーリングします

チーム

• list_fathom_teams — アクセス可能なすべてのチームを一覧表示します
• list_fathom_team_members — 特定のチームのメンバーを一覧表示します

Webhook

• create_fathom_webhook — 新しいミーティングのデータ（要約、文字起こし、アクションアイテム）を、管理する HTTPS URL に送信します
• delete_fathom_webhook — ID で Webhook を削除します

これらのツールが返す、呼び出し元が制御できるすべてのテキスト（ミーティングのタイトル、参加者名、AI による要約、文字起こしの各行、アクションアイテムの説明、チーム名）は、ホストがミーティングの内容を指示ではなくデータとして扱うよう、<untrusted-content> エンベロープで囲まれます。ツールエラーに表示されるベンダー API のエラー本文にも同じ処理が適用され、さらに長さが切り詰められます。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来的に MIT ライセンスに切り替わります。このソフトウェアは 2030-04-08 に MIT ライセンスに切り替わります。