
Model Context Protocol server for Fathom AI - access meeting recordings, transcripts, summaries, teams, and webhooks
概览
A Model Context Protocol (MCP) server for interacting with the Fathom AI API. This server provides tools for accessing meeting recordings, summaries, transcripts, teams, and webhooks. - : List meetings with advanced filtering (by participants, date ranges, teams) and optional inclusion of transcripts, summaries, action items, and CRM matches - : Retrieve meeting summaries (supports async delivery) - : Retrieve meeting transcripts with speaker information and timestamps (supports async delivery) - : List all accessible teams - : List team members with optional team filtering - : Create webhooks for meeting notifications with customizable triggers and content inclusion - : Delete webhooks by ID - : API information and available endpoints - : Rate limiting information and best practices 1. Clone this repository or copy the files to your local machine 2. Install dependencies using uv (recommended) or pip: The server auto-loads .env for local usage.
README
以下为原文 README 节选,完整内容请查看原文。
Fathom AI MCP Server
A Model Context Protocol (MCP) server for interacting with the Fathom AI API. This server provides tools for accessing meeting recordings, summaries, transcripts, teams, and webhooks.
Quick Start
git clone https://github.com/Dot-Fun/fathom-mcp.git
cd fathom-mcp
uv pip install fastmcp httpx pydantic
export FATHOM_API_KEY="your_api_key_here"
fastmcp run server.py
Features
Tools
- list_meetings: List meetings with advanced filtering (by participants, date ranges, teams) and optional inclusion of transcripts, summaries, action items, and CRM matches
- get_summary: Retrieve meeting summaries (supports async delivery)
- get_transcript: Retrieve meeting transcripts with speaker information and timestamps (supports async delivery)
- list_teams: List all accessible teams
- list_team_members: List team members with optional team filtering
- create_webhook: Create webhooks for meeting notifications with customizable triggers and content inclusion
- delete_webhook: Delete webhooks by ID
Resources
- fathom://api/info: API information and available endpoints
- fathom://api/rate-limits: Rate limiting information and best practices
Installation
-
Clone this repository or copy the files to your local machine
-
Install dependencies using uv (recommended) or pip:
# Using uv (recommended)
uv pip install -e .
# Or using pip
pip install -e .
- Set up your Fathom API key:
Create a .env file in the project root:
FATHOM_API_KEY=your_api_key_here
The server auto-loads .env for local usage.
Get your API key from the Fathom settings page.
Usage
Running the Server
Local Development (stdio)
# Using fastmcp CLI
fastmcp run server.py
# Or directly with Python
python server.py
HTTP Server
# Modify server.py to run as HTTP server
if __name__ == "__main__":
mcp.run(transport="http", host="0.0.0.0", port=8000)
Integrating with Claude Desktop
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"fathom": {
"command": "uv",
"args": [
"--directory",
"/path/to/fathom-mcp",
"run",
"fastmcp",
"run",
"server.py"
],
"env": {
"FATHOM_API_KEY": "your_api_key_here"
}
}
}
}
Integrating with Codex (alternative)
Add this block to your Codex config (~/.codex/config.toml):
[mcp_servers.fathom]
command = "uv"
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"fathom": {
"command": "uv",
"args": [
"--directory",
"/path/to/fathom-mcp",
"run",
"fastmcp",
"run",
"server.py"
],
"env": {
"FATHOM_API_KEY": "your_api_key_here"
}
}
}
}