Fathom MCP Enhanced

An enhanced MCP (Model Context Protocol) server for Fathom.video that provides comprehensive access to AI meeting transcripts, summaries, action items, team management, webhooks, and powerful analytics.

This project combines the best features from multiple Fathom MCP implementations:

• Core functionality from matthewbergvinson/fathom-mcp
• Analytics tools ported from lukas-bekr/fathom-mcp

Features

14 Tools Available

Core Meeting Tools

Tool	Description
list_meetings	List meetings with filters (date range, external participants only)
get_meeting	Get full meeting details including transcript, summary, action items, CRM matches
get_transcript	Get just the transcript for a specific meeting
export_meeting	Export a single meeting to a formatted markdown file
export_all_meetings	Batch export all meetings to markdown files
search_meetings	Search meetings by participant email, company domain, or team
get_action_items	Get action items from one or multiple recent meetings

Team Management

Tool	Description
list_teams	List all teams in your Fathom organization
list_team_members	List members of a specific team or all teams

Webhooks

Tool	Description
create_webhook	Create a webhook for meeting notifications
delete_webhook	Delete an existing webhook

Analytics (Enhanced)

Tool	Description
search_content	Full-text search across meeting transcripts and summaries with context snippets
meeting_stats	Get comprehensive meeting statistics (duration averages, internal/external ratio, team breakdown)
participant_stats	Analyze participant frequency, top recorders, and domain distribution

Installation

Prerequisites

• Node.js 18.0.0 or higher
• A Fathom.video account with API access
• Your Fathom API key

Setup

# Clone the repository
git clone https://github.com/mamba-mental/fathom-mcp-enhanced.git
cd fathom-mcp-enhanced

# Install dependencies
npm install

# Build the TypeScript
npm run build

Configuration

Environment Variables

Variable	Required	Description
FATHOM_API_KEY	Yes	Your Fathom API key
FATHOM_OUTPUT_DIR	No	Custom directory for exported transcripts (defaults to ./transcripts)

Getting Your Fathom API Key

1. Log into Fathom.video
2. Go to Settings → Integrations → API
3. Generate a new API key
4. Copy the key for use in configuration

Claude Desktop Integration

Add the following to your claude_desktop_config.json:

Windows

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["C:/mcp/fathom-mcp-enhanced/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your_fathom_api_key_here",
        "FATHOM_OUTPUT_DIR": "C:/Users/YourName/Documents/FathomTranscripts"
      }
    }
  }
}

macOS/Linux

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["/path/to/fathom-mcp-enhanced/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your_fathom_api_key_here",
        "FATHOM_OUTPUT_DIR": "/home/user/FathomTranscripts"
      }
    }
  }
}

Usage Examples

List Recent Meetings

Show me my last 10 meetings using list_meetings

Search Meeting Content

Use search_content to find all meetings where we discussed "quarterly budget"

Get Meeting Analytics

Use meeting_stats to analyze all my meetings from the last 30 days

Analyze Participants

Use participant_stats to show me who I meet with most frequently

Credits

This enhanced version combines work from multiple sources:

• Original Core Implementation: matthewbergvinson/fathom-mcp by Matthew Bergvinson
• Analytics Tools: Ported from lukas-bekr/fathom-mcp by Lukas Bekr
• Enhanced & Combined: Big Brother Master Journey (Prime)

License

This project is licensed under the MIT License - see the LICENSE file for details.