# 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
```