# fathom-mcp

An [MCP](https://modelcontextprotocol.io) server for the [Fathom](https://fathom.video) call recording API. Gives AI assistants (Claude Desktop, Claude Code, etc.) access to your meeting recordings, summaries, and transcripts.

## Tools

| Tool | Description |
|---|---|
| `list_meetings` | List call recordings with metadata (title, invitees, times). Supports filtering by date, recorder, and team. |
| `get_meeting_summary` | Get the AI-generated summary for a specific recording (markdown). |
| `get_meeting_transcript` | Get the full transcript for a specific recording (plain text). |
| `list_teams` | List teams in your Fathom organization. |
| `list_team_members` | List team members, optionally filtered by team. |

## Setup

### 1. Get a Fathom API key

Go to [Fathom](https://fathom.video) > User Settings > API Access and generate a key.

### 2. Install

```bash
git clone https://github.com/jhamman/fathom-mcp.git
cd fathom-mcp
uv venv .venv
uv pip install --python .venv/bin/python "mcp[cli]>=1.0.0" "fathom-python>=0.0.30"
```

### 3. Configure Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "fathom": {
      "command": "/path/to/fathom-mcp/.venv/bin/python",
      "args": ["/path/to/fathom-mcp/server.py"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### Configure Claude Code

```bash
claude mcp add fathom -- /path/to/fathom-mcp/.venv/bin/python /path/to/fathom-mcp/server.py
```

Set the API key in your environment:

```bash
export FATHOM_API_KEY="your-api-key-here"
```

## Usage

Once configured, you can ask your AI assistant things like:

- "List my recent Fathom meetings"
- "Get the summary from my meeting with [person] last week"
- "Pull the transcript from recording 12345"
- "What action items came out of my meetings this week?"

## License

MIT