🌉 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.

---

✨ 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
2. Go to Settings → Integrations → API
3. Copy your API key

Step 2 — Add to Your AI Tool Config

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

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

Cursor (.cursor/mcp.json):

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

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

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

Gemini CLI (~/.gemini/settings.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 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 by Anthropic. Powered by Fathom.