Fathom

@mindstone/mcp-server-fathom

通过 Fathom AI 列出和搜索会议、查看详情、阅读文字稿并管理团队。

仅在本地运行的 Fathom MCP。非官方服务——在 Fathom 发布其官方服务之前构建；令牌保存在磁盘上，每次发布前都会经过我们自己的安全审查。

状态

• 版本： 0.3.0 · npm
• 身份验证： API 密钥（FATHOM_API_KEY）
• 工具： 12（会议、文字稿、行动项、录音、团队、Webhook）
• 服务类型： 云 API
• 机器可读： STATUS.json

为什么要构建这个服务

我们在 2026 年初构建此服务时，Fathom 尚未发布官方 MCP 服务，当时可用的社区方案也很少，且缺乏维护——它们可以列出会议，却无法提供我们的会议笔记工作流所依赖的团队和文字稿数据。我们自行构建了这个服务，让任何 MCP 宿主都能获取 Fathom 文字稿和会议详情，并采用与本仓库其他部分相同的凭据处理、超时设置和安全封装。此后，Fathom 已发布官方 MCP 服务；我们仍会维护这个服务，因为它在用户的机器上本地运行，且每次发布前都会经过我们自己的安全审查。

交互示例

“从 Fathom 调取昨天的 Q3 规划会议，并列出文字稿中的行动项。”

宿主调用的工具：

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 — 功能源代码许可证 1.1 版，附带未来适用的 MIT 许可证。该软件将于 2030-04-08 转为 MIT 许可证。