# Fathom AI MCP

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/jerichosequitin/fathom-ai-mcp)
[![npm version](https://img.shields.io/npm/v/@jerichosequitin/fathom-ai-mcp)](https://www.npmjs.com/package/@jerichosequitin/fathom-ai-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20.0.0-brightgreen?logo=node.js&logoColor=white)](https://nodejs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![GitHub stars](https://img.shields.io/github/stars/jerichosequitin/fathom-ai-mcp)](https://github.com/jerichosequitin/fathom-ai-mcp/stargazers)

[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-FFDD00?logo=buymeacoffee&logoColor=black)](https://buymeacoffee.com/jerichosequitin)

A Model Context Protocol server for the [Fathom AI](https://fathom.video) meeting intelligence API. Responses are optimized for LLM consumption - compact plaintext instead of raw JSON, with playback URLs stripped and transcripts chunked by time window.

[![fathom-ai-mcp MCP server](https://glama.ai/mcp/servers/jerichosequitin/fathom-ai-mcp/badges/card.svg)](https://glama.ai/mcp/servers/jerichosequitin/fathom-ai-mcp)

## Tools

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

All list tools support `page` and `page_size` params with random page access (no sequential fetching required). Use `participants` on `list_meetings` to filter by user email.

## Prerequisites

1. Install [Node.js](https://nodejs.org/) (v20+).

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

## Installation

### Option 1: Claude Desktop

1. Download `fathom-ai-mcp.mcpb` from [Releases](https://github.com/jerichosequitin/fathom-ai-mcp/releases)
2. Open the `.mcpb` file with Claude Desktop to install
3. Configure your Fathom API key in Claude Desktop's extension settings

### Option 2: Manual Configuration

Add the following to your MCP client configuration:

```jsonc
{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": ["-y", "@jerichosequitin/fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}
```

**Config file locations:**

- **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
- **Cursor**: `.cursor/mcp.json` in your project root
- **Windsurf**: `~/.codeium/windsurf/mcp_config.json`

### Claude Code

```bash
claude mcp add Fathom -e FATHOM_API_KEY=your-api-key -- npx @jerichosequitin/fathom-ai-mcp
```

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `FATHOM_API_KEY` | Yes | Your Fathom API key |

## For Developers

### Setup

```bash
git clone https://github.com/jerichosequitin/fathom-ai-mcp.git
cd fathom-ai-mcp
npm install
npm run build
npm start
```

### Scripts

| Command | Description |
|---------|-------------|
| `npm run build` | Compile TypeScript |
| `npm run validate` | Type-check + lint + format check |
| `npm run lint:fix` | Auto-fix lint issues |
| `npm run format` | Auto-format with Prettier |
| `npm run mcpb:build` | Build MCPB package for Claude Desktop |

### Building MCPB Package

```bash
npm run mcpb:build
```

Creates `fathom-ai-mcp-{version}.mcpb` ready for GitHub Releases.

## License

This project is licensed under the MIT License.