MCP 服务器

Fathom MCP Server

Enables LLMs to interact with Fathom.video API for managing meeting recordings, retrieving transcripts and AI-generated summaries, searching meeting content, and accessing analytics and team data.

README

Fathom MCP Server

An MCP (Model Context Protocol) server that enables LLMs to interact with the Fathom.video API for meeting recording management, transcripts, summaries, and analytics.

Features

List and filter meetings - Access your Fathom meeting recordings with powerful filtering
Get transcripts and summaries - Retrieve AI-generated summaries and full transcripts
Team management - List teams and team members in your organization
Webhook management - Create and delete webhooks for real-time notifications
Search meetings - Full-text search across meeting content
Analytics - Get meeting statistics and participant insights

Installation

# Clone or download the repository
git clone <repository-url>
cd fathom-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Get Your Fathom API Key

Log in to Fathom
Go to Settings > API
Generate or copy your API key

Claude Desktop Setup

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["/absolute/path/to/fathom-mcp/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variable

Alternatively, set the environment variable:

export FATHOM_API_KEY=your-api-key-here

Available Tools

Core API Tools

Tool	Description
`fathom_list_meetings`	List meetings with filtering by date, team, domain, recorder
`fathom_get_summary`	Get AI-generated summary for a recording
`fathom_get_transcript`	Get full transcript with speaker identification
`fathom_list_teams`	List all teams in your organization
`fathom_list_team_members`	List members of a specific team
`fathom_create_webhook`	Create a webhook for meeting notifications
`fathom_delete_webhook`	Delete an existing webhook

Helper Tools

Tool	Description
`fathom_search_meetings`	Search across meeting titles, transcripts, and summaries
`fathom_meeting_stats`	Get analytics: duration stats, team breakdown, meeting types
`fathom_participant_stats`	Get participant frequency and domain analysis

Usage Examples

List Recent Meetings

"Show me my recent meetings"

Get Meeting Summary

"Get the summary for recording 123456789"

Search Meetings

"Search my meetings for discussions about 'quarterly budget'"

Filter by Team

"List all Sales team meetings from last month"

Get Analytics

"Show me meeting statistics for this quarter"

Create a Webhook

"Create a webhook to https://my-app.com/webhook for my recordings"

Response Formats

All tools support two response formats:

markdown (default): Human-readable formatted output
json: Structured data for programmatic processing

Specify the format using the response_format parameter.

Rate Limits

The Fathom API has a rate limit of 60 requests per minute. The server handles rate limiting gracefully and will return an error message if the limit is exceeded.

Development

# Install dependencies
npm install

# Development with auto-reload
npm run dev

# Build
npm run build

# Type checking
npm run typecheck

# Run the server
npm start

Project Structure

fathom-mcp/
├── src/
│   ├── index.ts           # Main entry point
│   ├── types.ts           # TypeScript interfaces
│   ├── constants.ts       # Configuration constants
│   ├── schemas/           # Zod validation schemas
│   ├── services/          # API client
│   └── tools/             # Tool implementations
├── dist/                  # Compiled output
├── package.json
├── tsconfig.json
├── PRD.md                 # Project requirements
├── CHANGELOG.md           # Version history
└── README.md