# 🌉 FathomBridge

> Your meetings, in your AI.

**FathomBridge** is a zero-install MCP (Model Context Protocol) server
that connects any AI CLI or IDE directly to your Fathom meeting
transcripts, summaries, and action items — using your API key.

No cloning. No building. One line of config.

[![npm version](https://img.shields.io/npm/v/fathombridge)](https://www.npmjs.com/package/fathombridge)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)

---

## ✨ Features

- 📋 **List meetings** — with date, team, and pagination filters
- 📝 **Full transcripts** — speaker-labelled with timestamps
- 🤖 **AI summaries** — key points and decisions
- ✅ **Action items** — with owners and due dates
- 🔍 **Smart search** — find any meeting by title, host, or participant
- 👥 **Teams** — list your Fathom organization teams
- ⚡ **Zero install** — runs via npx, nothing to clone or build
- 🔑 **API key auth** — simple, local, no OAuth flow needed

---

## 🚀 Quick Start

### Step 1 — Get Your Fathom API Key

1. Log in to [fathom.video](https://fathom.video)
2. Go to **Settings → Integrations → API**
3. Copy your API key

### Step 2 — Add to Your AI Tool Config

**Claude Code** (`~/.claude/claude.json`):

```json
{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["-y", "fathombridge"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

**Cursor** (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["-y", "fathombridge"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

**Windsurf** (`~/.codeium/windsurf/mcp_config.json`):

```json
{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["-y", "fathombridge"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

**Gemini CLI** (`~/.gemini/settings.json`):

```json
{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["-y", "fathombridge"],
      "env": {
        "FATHOM_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### Step 3 — Restart Your AI Tool

Restart Claude Code / Cursor / Windsurf and verify:

```
/mcp
```

You should see `fathom` listed as connected.

---

## 🛠️ Available Tools

| Tool               | Description                          |
| ------------------ | ------------------------------------ |
| `list_meetings`    | List meetings with date/team filters |
| `get_transcript`   | Full transcript with speaker labels  |
| `get_summary`      | AI summary + key points              |
| `get_action_items` | Action items with owners/due dates   |
| `search_meetings`  | Search by title, host, participant   |
| `list_teams`       | List organization teams              |

---

## 💬 Example Prompts

Once connected, try these in your AI tool:

```
Show me my last 5 Fathom meetings

Get the transcript from my sprint planning call yesterday

What were the action items from the client call with John?

Search for all meetings about the Q3 roadmap

Show me all meetings from this week with action items

Get the summary of meeting ID abc123
```

---

## 🔒 Security

- Your API key is stored only in your local MCP config
- All requests go directly from your machine to Fathom's API
- No data is stored, logged, or transmitted to any third party
- Never commit your API key to version control

---

## 🔧 Troubleshooting

**`fathom` not showing in `/mcp`**
→ Restart your AI tool after editing the config file

**`Error: FATHOM_API_KEY environment variable is required`**
→ Make sure the env block in your config has your actual API key

**`Error: 401 Unauthorized`**
→ Your API key is invalid — regenerate it at fathom.video → Settings → API

**`No meetings found`**
→ Your API key only accesses meetings recorded by you or shared to your team

**Transcript not available yet**
→ Fathom takes a few minutes to process transcripts after a call ends

---

## 📋 Requirements

- Node.js 18 or higher
- A [Fathom](https://fathom.video) account
- A Fathom API key

---

## 🤝 Contributing

Contributions welcome! Please:

1. Fork the repo
2. Create a feature branch
3. Make your changes with tests
4. Submit a PR with a clear description

---

## 📄 License

MIT © 2026 Nauman Pathan

---

## 🙏 Acknowledgements

Built on top of the [Model Context Protocol](https://modelcontextprotocol.io)
by Anthropic. Powered by [Fathom](https://fathom.video).