Fathom MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop (and other MCP clients) to access your Fathom meeting intelligence — list meetings, read summaries, search by title, and pull full transcripts.

Features

Meeting Intelligence Tools

Built-in Reliability

• Token-bucket rate limiter — respects Fathom's 60 req/min limit client-side

• Auto-retry on 429 — exponential backoff (2s, 4s, 8s) up to 3 retries

• Structured error responses — actionable error messages with status codes and recovery hints

• Prompt injection protection — external content wrapped in randomised EXTCONTENT markers

Related MCP server: Fathom AI MCP Server

Quick Start

Prerequisites

• Node.js 22.14 or higher

• A Fathom account with API access

• Claude Desktop (or any MCP-compatible client)

Get Your Fathom API Key

1. Go to Fathom Settings

2. Generate an API key

Installation

Published package: @luminarylane/fathom-mcp-server on npm

Option 1: npx (Recommended — Zero Install)

# Test it works
FATHOM_API_KEY=your-key npx --yes @luminarylane/fathom-mcp-server

Claude Desktop configuration:

{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["--yes", "@luminarylane/fathom-mcp-server"],
      "env": {
        "FATHOM_API_KEY": "your-fathom-api-key"
      }
    }
  }
}

Option 2: Install from npm

npm install -g @luminarylane/fathom-mcp-server

Then configure Claude Desktop:

{
  "mcpServers": {
    "fathom": {
      "command": "luminarylane-fathom-mcp",
      "env": {
        "FATHOM_API_KEY": "your-fathom-api-key"
      }
    }
  }
}

Option 3: Install from Source

git clone https://github.com/luminarylane/fathom-mcp-server.git
cd fathom-mcp-server
npm install
npm run build

Then configure Claude Desktop:

{
  "mcpServers": {
    "fathom": {
      "command": "node",
      "args": ["/path/to/fathom-mcp-server/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your-fathom-api-key"
      }
    }
  }
}

Usage Examples

Once configured, ask Claude to:

• "What meetings did I have this week?"

• "Get the summary for my last standup"

• "Search for meetings about product roadmap"

• "Pull the transcript from my meeting with the design team"

• "List all meetings from the past month"

Authentication

Set the FATHOM_API_KEY environment variable with your API key from Fathom Settings.

Rate Limits

Fathom enforces 60 requests per 60 seconds per user. The server handles this automatically with a client-side token bucket and exponential backoff retries.

Troubleshooting

Missing API key

FATHOM_API_KEY env var is required

Set the FATHOM_API_KEY environment variable before starting the server.

401 Authentication failed

AUTH_FAILED: FATHOM_API_KEY is invalid or expired.

Check your API key in Fathom Settings and regenerate if needed.

Rate limit exceeded

RATE_LIMITED: Fathom rate limit (60/min). Wait 60s and retry.

The server handles short waits automatically. For longer windows, wait and retry.

Reporting Issues

1. Check existing issues

2. Open a new issue with the full error message, steps to reproduce, and your environment details

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

npm install
npm run dev        # Dev mode
npx tsc --noEmit   # Type check
npx prettier --write .  # Format

License

MIT License — see LICENSE for details.

Acknowledgments

• Anthropic for the MCP specification

• Fathom for meeting intelligence