# Fathom MCP Server

Stop switching between your IDE and Fathom's web UI. Query your meeting transcripts, summaries, and action items directly from Cursor, Claude Desktop, or any MCP-compatible AI assistant.

**The actual use case:** You're coding and remember someone mentioned a specific UI change in last week's design review. Instead of opening Fathom, finding the meeting, and scrubbing through the recording, just ask your AI: *"What did Sarah say about the dashboard layout in last week's design meeting?"* and implement it immediately.

Built for developers who want meeting context without context switching.

## Features

- **List Meetings**: Search and filter meetings by date, teams, participants, or domains
- **Get Summaries**: Retrieve AI-generated summaries for specific recordings
- **Get Transcripts**: Access full meeting transcripts with speaker attribution
- **Team Management**: List teams and team members in your organization
- **Action Items**: Extract action items from meetings
- **CRM Integration**: Include CRM matches in meeting data

## Quick Setup

### Prerequisites

- A Fathom account with API access
- Your Fathom API key ([Get it here](https://app.fathom.video/settings/integrations/api))

### Configuration

Add this to your MCP client configuration:

#### For Cursor

Add to `~/.cursor/mcp.json` (or create it if it doesn't exist):

```json
{
  "mcpServers": {
    "fathom": {
      "transport": "streamable_http",
      "url": "https://fathommcp-production.up.railway.app/mcp",
      "headers": {
        "x-api-key": "YOUR_FATHOM_API_KEY"
      }
    }
  }
}
```

#### For Claude Desktop

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

```json
{
  "mcpServers": {
    "fathom": {
      "transport": "streamable_http",
      "url": "https://fathommcp-production.up.railway.app/mcp",
      "headers": {
        "x-api-key": "YOUR_FATHOM_API_KEY"
      }
    }
  }
}
```

#### For Other MCP-Compatible Clients

Use the same configuration format with:
- **Transport**: `streamable_http`
- **URL**: `https://fathommcp-production.up.railway.app/mcp`
- **Header**: `x-api-key` with your Fathom API key

### Getting Your Fathom API Key

1. Log in to [Fathom](https://app.fathom.video)
2. Go to Settings → Integrations → API
3. Generate or copy your API key
4. Replace `YOUR_FATHOM_API_KEY` in the configuration above

## Real-World Usage

This isn't just another MCP server - it puts your meeting context directly into your coding workflow. Here's how you actually use it:

### In Cursor (while coding)

**Implement based on meeting feedback:**
- "Pull up the transcript from yesterday's product review with Sarah - what UI changes did she request for the dashboard?"
- "What did the design team say about the button colors in last Friday's meeting? Update the theme file based on that"
- "Check what Mark mentioned about the API response format in this week's standup and refactor accordingly"

**Debug with context:**
- "Find the meeting where we discussed the authentication bug - what was the root cause they identified?"
- "What did the customer say was broken in their demo call? Let me fix that exact flow"

**Build features from discussions:**
- "Get the specs for the export feature from the planning meeting with engineering"
- "What were the exact requirements the client mentioned for the search functionality? Implement that"

**Reference technical decisions:**
- "Why did we decide to use Redis over PostgreSQL for caching? Pull that from the architecture meeting"
- "What performance targets did we agree on in the infrastructure call?"

### In Claude Desktop

**Meeting prep & follow-up:**
- "Summarize all meetings with Acme Corp from last month"
- "What action items did I commit to in this week's meetings?"
- "Pull the transcript from the sales call - I need to draft a follow-up email"

**Cross-reference discussions:**
- "Find all meetings where we discussed the pricing model"
- "Show me what different teams said about the mobile app redesign"

## Available Tools

The MCP server provides these tools:

- `list_meetings` - Search and filter meetings with optional transcript/summary inclusion
- `get_summary` - Get AI summary for a specific recording
- `get_transcript` - Get full transcript for a specific recording
- `list_teams` - List all teams in your organization
- `list_team_members` - List members of your teams

## Self-Hosting

To run your own instance:

### Local Development

```bash
# Clone the repository
git clone <your-repo-url>
cd fathom_mcp

# Install dependencies
pip install -r requirements.txt

# Run the server
python fathom_mcp.py
```

### Deploy to Railway

1. Fork this repository
2. Connect to [Railway](https://railway.app)
3. Deploy from your GitHub repository
4. Railway will automatically detect and deploy the FastMCP server

## Why This Is Actually Useful

**Stop context switching.** Instead of pausing your code to dig through Fathom's web UI, just ask while you're in your IDE:

- **Code from memory, not notes**: "What did the PM say about error handling?" - implement it right then and there
- **Ship what was actually requested**: No more building features based on vague Slack messages. Get the exact words from the meeting
- **Debug faster**: "Pull the bug description from the customer call" - fix what they actually reported, not what got lost in translation
- **No meeting notes FOMO**: Missed a standup? Get the key points without scrubbing through a recording
- **Build better demos**: "What questions did the client ask last time?" - address them proactively in your next version
- **Onboard faster**: New to a project? Search all past meetings about it and get up to speed
- **Write better PRs**: Reference the exact meeting discussion when explaining why you made specific technical decisions

## API Documentation

This server uses the [Fathom External API v1](https://api.fathom.ai/external/v1). All tools support the full range of filters and options available in the Fathom API.

## Support

Need help setting it up? Feel free to reach out or open an issue.

## License

MIT