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

1. Install Node.js (v20+).

2. Get a Fathom API key: go to Fathom Settings > API Access > Add + > Generate API Key.

Installation

Option 1: Claude Desktop

1. Download fathom-ai-mcp.mcpb from Releases
2. Open the .mcpb file with Claude Desktop to install
3. 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.json in 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.