Fathom MCP Server

开心的时光总是短暂！Fathom 现在有了官方 MCP：https://developers.fathom.ai/mcp-docs

不过，我计划为这个 MCP 添加高度可自定义的工具，因此等我有时间后，或有人参与贡献时，我会继续维护和扩展它。

---

开始使用

此服务已发布到 MCP Registry，名称为 io.github.agencyenterprise/fathom-mcp-server。

Claude Desktop（Streamable HTTP）

不到 60 秒即可完成连接：

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

1. 打开 Claude Desktop
2. 前往 设置 > 连接器 > 添加自定义连接器
3. 粘贴上方的 URL
4. 使用 Fathom 进行身份验证

就这样。向 Claude 询问你的会议内容吧。

组织：管理员必须通过组织管理设置添加连接器，而不是通过个人设置添加。

Perplexity Desktop 及其他 SSE 客户端

对于使用旧版 SSE 传输的客户端（例如 Mac 版 Perplexity Desktop），请使用 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 页结果。这是一个 MCP 原生工具，由于 Fathom 的 API 未提供搜索端点，因此会在客户端执行筛选。

有关完整的请求和响应参数，请参阅 Fathom MCP 服务文档。

在 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 权限范围，而是此 MCP 服务专用的权限范围，用于说明对您的 Fathom 数据的只读访问权限。

Fathom API 本身仅通过 public_api 权限范围提供读取权限。Fathom API 不支持写入操作（创建／编辑会议、文字记录等）。

限制

• search_meetings 会在客户端执行筛选，因为 Fathom 的 API 不提供搜索端点。对于会议较多的用户，请改用带日期筛选条件的 list_meetings。
• 您随时可以询问大模型有哪些可用的查询参数。

自行托管

Fathom OAuth 应用要求重定向 URI 使用 HTTPS，因此无法使用 http://localhost 进行本地开发。请部署到托管平台进行测试。

1. 部署到托管平台

Railway（推荐）、Render，或任何提供以下服务的平台：

• Node.js 18+ 运行时
• PostgreSQL 数据库
• HTTPS URL

Railway 设置：

1. Fork／克隆此仓库
2. 创建新的 Railway 项目（可以直接从 Fork 的 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 会自动设置——请使用公开数据库 URL）
BASE_URL	应用的公开 URL（例如：https://your-app.railway.app）
TOKEN_ENCRYPTION_KEY	32 字节十六进制密钥（使用 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

在 Claude Desktop 中将已部署的 URL 添加为自定义连接器：

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。

Beta 测试

预发布功能请使用暂存 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。

未来开发计划

• 转录内容向量化 — 支持对大型转录内容进行向量化，让大模型能够更高效地解析和理解内容。该功能将通过无状态工作进程实现，确保不保留任何用户数据。
• 汇总行动项 — 使用筛选条件汇总多场会议中的行动项。例如：“显示我本周所有未完成的行动项。”
• 会议分析 — 统计总会议时长、会议频率和参会人数最多的人员等数据。
• 发言时长分析 — 分析转录内容，显示会议中发言最多的人。
• 会议对比 — 对比两份会议摘要，突出显示一段时间内的变化。
• Fathom API 更新日志监控 — 通过 GitHub Action 自动检测 Fathom API 的变更：定期检查其 API 参考文档，并在检测到变更时创建 issue。

欢迎为这些目标贡献力量。请参阅 CONTRIBUTING.md。

许可证

MIT 许可证 — 详情请参阅 LICENSE。