# Fathom Video MCP Server
An MCP (Model Context Protocol) server that provides access to your [Fathom](https://fathom.video) meeting recordings, AI-generated summaries, and transcripts.
## Features
- **List Meetings** - Browse your Fathom meetings with filtering by date, recorder, or team
- **Get Summaries** - Retrieve AI-generated meeting summaries in markdown format
- **Get Transcripts** - Access full transcripts with speaker attribution and timestamps
## Installation
### From source
```bash
git clone https://github.com/trevorwelch/fathom-video-mcp.git
cd fathom-video-mcp
uv sync
```
## Configuration
### Step 1: Get your Fathom API Key
1. Login to your Fathom account, go to [fathom.video/api_settings/new](https://fathom.video/api_settings/new)
2. Select **Generate Api Key**
3. Copy your new API key and save it somewhere secure
### Step 2: Add to Claude Code or Claude Desktop
Choose one of the following based on which Claude app you use.
#### Claude Code
Edit `~/.claude/settings.json`:
```json
{
"mcpServers": {
"fathom": {
"command": "uv",
"args": ["run", "--directory", "/path/to/fathom-video-mcp", "fathom-video-mcp"],
"env": {
"FATHOM_API_KEY": "your-api-key-here"
}
}
}
}
```
Replace `/path/to/fathom-video-mcp` with the actual path where you cloned the repo.
#### Claude Desktop
Edit your config file:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"fathom": {
"command": "uv",
"args": ["run", "--directory", "/path/to/fathom-video-mcp", "fathom-video-mcp"],
"env": {
"FATHOM_API_KEY": "your-api-key-here"
}
}
}
}
```
Replace `/path/to/fathom-video-mcp` with the actual path where you cloned the repo.
### Step 3: Restart Claude
Restart Claude Code or Claude Desktop to load the new MCP server. You should now be able to ask Claude about your Fathom meetings.
## Available Tools
### list_meetings
List your Fathom meetings with optional filters.
**Parameters:**
- `limit` (int, optional): Maximum number of meetings to return (1-50)
- `search` (string, optional): Smart search - matches titles, attendee names, and email domains
- `cursor` (string, optional): Pagination cursor from previous response
- `created_after` (string, optional): ISO timestamp to filter meetings after
- `created_before` (string, optional): ISO timestamp to filter meetings before
- `include_summary` (bool, optional): Include AI summary in response
- `include_transcript` (bool, optional): Include transcript in response
- `include_action_items` (bool, optional): Include action items in response
- `recorded_by` (list[string], optional): Filter by recorder email addresses
- `teams` (list[string], optional): Filter by team names
- `calendar_invitees_domains_type` (string, optional): Filter by invitee type ('all', 'only_internal', 'one_or_more_external')
- `invitee_domains` (list[string], optional): Filter by invitee email domains (e.g., ['acme.com'])
**Example:**
```
List my meetings from the last week
```
### get_summary
Get the AI-generated summary for a specific meeting.
**Parameters:**
- `recording_id` (int, required): The recording ID from list_meetings
**Example:**
```
Get the summary for meeting 123456789
```
### get_transcript
Get the full transcript with speaker attribution.
**Parameters:**
- `recording_id` (int, required): The recording ID from list_meetings
**Example:**
```
Get the transcript for meeting 123456789
```
## Development
### Running locally
```bash
cd fathom-video-mcp
uv sync
export FATHOM_API_KEY="your-api-key"
uv run python -m fathom_video_mcp.server
```
