Fathom MCP Server

An MCP 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.

Quick Start

No cloning or installing required. Just add the server to your MCP client config.

Claude Code

claude mcp add Fathom -e FATHOM_API_KEY=your-api-key -- npx @jerichosequitin/fathom-ai-mcp

Cursor / Windsurf

Add to your MCP config file:

• Cursor: .cursor/mcp.json in your project root
• Windsurf: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": ["@jerichosequitin/fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Download the .mcpb file from the latest release and open it -- Claude Desktop will install the server and prompt for your API key.

Alternatively, add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": ["@jerichosequitin/fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | FATHOM_API_KEY | Yes | Your Fathom API key |

Development

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 |

License

MIT