Metadata-Version: 2.4
Name: fathom-ai-mcp
Version: 0.1.1
Summary: MCP server for the Fathom AI meeting intelligence API
Project-URL: Homepage, https://github.com/jerichosequitin/fathom-ai-mcp
Project-URL: Repository, https://github.com/jerichosequitin/fathom-ai-mcp
Project-URL: Issues, https://github.com/jerichosequitin/fathom-ai-mcp/issues
Author-email: Jericho Sequitin <jericho@bravastech.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,fathom,mcp,meetings,transcripts
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# Fathom MCP Server

An MCP server for the [Fathom AI](https://fathom.video) meeting intelligence API, built with [FastMCP](https://gofastmcp.com).

Responses are optimized for LLM consumption -- compact plaintext instead of raw JSON, with playback URLs stripped and transcripts chunked by time window.

## Tools

| Tool | Description |
|------|-------------|
| `list_meetings` | List meetings with filtering by date, team, domain, recorder, and pagination |
| `get_transcript` | Get transcript for a recording, with optional time-window chunking (`start_time`/`end_time`) |
| `get_summary` | Get the AI-generated summary for a recording (clean markdown, no playback URLs) |
| `list_teams` | List all teams |
| `list_team_members` | List team members, optionally filtered by team |

## Prerequisites

1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/):

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

2. Get a Fathom API key: go to [Fathom Settings](https://fathom.video/customize) > **API Access** > **Add +** > **Generate API Key**.

## Quick Start

No cloning or installing required. Just add the server to your MCP client config.

### Claude Code

```bash
claude mcp add fathom -e FATHOM_API_KEY=your-api-key -- uvx fathom-ai-mcp
```

### Cursor / Windsurf

Add to your MCP config file:

- **Cursor**: `.cursor/mcp.json` in your project root
- **Windsurf**: `~/.codeium/windsurf/mcp_config.json`

```json
{
  "mcpServers": {
    "fathom": {
      "command": "uvx",
      "args": ["fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Claude Desktop

Claude Desktop doesn't inherit your shell's PATH, so you need to use the full path to `uvx`.

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

```json
{
  "mcpServers": {
    "fathom": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uvx",
      "args": ["fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}
```

To find your `uvx` path, run `which uvx` in your terminal.

### Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `FATHOM_API_KEY` | Yes | - | Your Fathom API key |
| `FATHOM_TIMEOUT` | No | `30` | HTTP request timeout in seconds |

## Development

```bash
git clone https://github.com/jerichosequitin/fathom-ai-mcp.git
cd fathom-ai-mcp
uv sync
uv run server.py
```

## License

MIT
