README.md
An MCP server for the Fathom AI meeting intelligence API
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.
Tools (5)
list_meetingsList meetings with filtering by date, team, domain, participant, and paginationget_transcriptGet transcript for a recording, with optional time-window chunkingget_summaryGet AI-generated summaries for one or more recordingslist_teamsList all teamslist_team_membersList team members, optionally filtered by teamEnvironment Variables
FATHOM_API_KEYrequiredYour Fathom API keyConfiguration
claude_desktop_config.json
{"mcpServers": {"Fathom": {"command": "npx", "args": ["-y", "@jerichosequitin/fathom-ai-mcp"], "env": {"FATHOM_API_KEY": "your-api-key"}}}}Try it
→List my meetings from the last week.
→Get the summary for the most recent team meeting.
→Retrieve the transcript for the meeting with ID 12345.
→Who are the members of the engineering team?
→Find all meetings where user@example.com participated.