Fathom MCP

🚀 fathom-mcp

A Model Context Protocol (MCP) server that integrates Fathom.video with AI coding assistants like Cursor, enabling users to query meeting transcripts, export recordings, and manage webhooks via natural language.

🚀 Quick Start

1. Get Your Fathom API Key

1. Navigate to Fathom Settings.
2. Go to API Access.
3. Click Generate API Key.

2. Install the MCP Server

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

3. Configure Cursor

Add the following to your ~/.cursor/mcp.json:

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

⚠️ Important Note

Replace /path/to/fathom-mcp with the actual path where you cloned the repo, and add your Fathom API key.

4. Restart Cursor

Restart Cursor to load the MCP server. You can now use natural language to interact with your Fathom data:

• "List my last 5 Fathom meetings"
• "Get the transcript from my call with John"
• "Export yesterday's meetings to markdown"
• "Show me action items from this week"

✨ Features

• 📋 List & Search Meetings — Browse recordings with filters for date, team, participants, or external domains.
• 📝 Full Transcripts — Get speaker-labeled, timestamped transcripts formatted as markdown.
• 📊 AI Summaries — Access Fathom's AI-generated meeting summaries.
• ✅ Action Items — Pull action items from specific meetings or across recent calls.
• 📁 Export to Markdown — Save meetings as MeetingTitle_YYYY-MM-DD.md files.
• 👥 Team Management — List teams and team members.
• 🔔 Webhooks — Create and manage webhooks for real-time notifications.

📦 Installation

The installation steps are included in the Quick Start section.

💻 Usage Examples

Basic Usage

You can use natural language queries like "List my last 5 Fathom meetings" after setting up the MCP server and configuring Cursor.

Advanced Usage

Use more complex queries to interact with different features, such as "Get action items from meetings with John in the last week".

📚 Documentation

Available Tools

Meeting Operations

Export Operations

Action Items

Team Management

Webhooks

Tool Parameters

Exported Transcript Format

Exported meetings are saved as markdown with:

• Metadata table — Date, duration, participants, Fathom links.
• AI Summary — Fathom's generated summary.
• Action Items — With assignees and completion status.
• Full Transcript — Speaker-labeled with timestamps.

Example filename: Quarterly_Business_Review_2024-12-01.md

# Quarterly Business Review

## Meeting Details
| Field | Value |
|-------|-------|
| **Date** | Sunday, December 1, 2024 at 10:00 AM |
| **Duration** | 45m 32s |
| **Recorded by** | Jane Smith <jane@company.com> |

## Participants
- **John Doe** <john@client.com> _(external)_
- **Jane Smith** <jane@company.com>

## Summary
> Key discussion points and outcomes...

## Action Items
- [ ] Follow up on proposal _(assigned to Jane)_
- [x] Send meeting notes

## Transcript
**John Doe** _[00:00:15]_
> Thanks for joining today...

🔧 Technical Details

Rate Limits

The Fathom API allows 60 requests per minute. The MCP server handles this gracefully.

Security

• API keys are stored in Cursor's MCP configuration (not in code).
• Never commit your mcp.json or API keys to version control.
• Webhook secrets should be stored securely.

Troubleshooting

MCP not loading?

• Ensure you've restarted Cursor after editing mcp.json.
• Check the path to dist/index.js is correct.
• Verify your API key is valid.

"fetch failed" errors?

• Ensure you're using Node.js 18 or higher.
• Check your network connection.
• Verify API key permissions in Fathom settings.

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode for development
npm run dev

📄 License

This project is under the MIT License. See LICENSE for details.

Author

Matthew Bergvinson
Vigilante Consulting

Need Custom AI Tools Built Fast?

We build production-ready MCP servers, AI integrations, and automation tools for businesses.

📧 operations@vigilanteconsulting.com

This MCP server is not officially affiliated with Fathom Video, Inc.