Fathom AI MCP
A Model Context Protocol server for the Fathom AI meeting intelligence API. Responses are optimized for LLM consumption - compact plaintext instead of raw JSON, with playback URLs stripped and transcripts chunked by time window.
Tools
| Tool | Description |
|---|---|
list_meetings | List meetings with filtering by date, team, domain, participant, and pagination |
get_transcript | Get transcript for a recording, with optional time-window chunking (start_time/end_time) |
get_summary | Get AI-generated summaries for one or more recordings (clean markdown, no playback URLs) |
list_teams | List all teams |
list_team_members | List team members, optionally filtered by team |
All list tools support page and page_size params with random page access (no sequential fetching required). Use participants on list_meetings to filter by user email.
Prerequisites
-
Install Node.js (v20+).
-
Get a Fathom API key: go to Fathom Settings > API Access > Add + > Generate API Key.
Installation
Option 1: Claude Desktop
- Download
fathom-ai-mcp.mcpbfrom Releases - Open the
.mcpbfile with Claude Desktop to install - Configure your Fathom API key in Claude Desktop's extension settings
Option 2: Manual Configuration
Add the following to your MCP client configuration:
{
"mcpServers": {
"Fathom": {
"command": "npx",
"args": ["-y", "@jerichosequitin/fathom-ai-mcp"],
"env": {
"FATHOM_API_KEY": "your-api-key"
}
}
}
}
Config file locations:
- Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%APPDATA%\Claude\claude_desktop_config.json(Windows) - Cursor:
.cursor/mcp.jsonin your project root - Windsurf:
~/.codeium/windsurf/mcp_config.json
Claude Code
claude mcp add Fathom -e FATHOM_API_KEY=your-api-key -- npx @jerichosequitin/fathom-ai-mcp
Environment Variables
| Variable | Required | Description |
|---|---|---|
FATHOM_API_KEY | Yes | Your Fathom API key |
For Developers
Setup
git clone https://github.com/jerichosequitin/fathom-ai-mcp.git
cd fathom-ai-mcp
npm install
npm run build
npm start
Scripts
| Command | Description |
|---|---|
npm run build | Compile TypeScript |
npm run validate | Type-check + lint + format check |
npm run lint:fix | Auto-fix lint issues |
npm run format | Auto-format with Prettier |
npm run mcpb:build | Build MCPB package for Claude Desktop |
Building MCPB Package
npm run mcpb:build
Creates fathom-ai-mcp-{version}.mcpb ready for GitHub Releases.
License
This project is licensed under the MIT License.