MCP Fathom Server

An MCP (Model Context Protocol) server that integrates with Fathom AI's meeting API, enabling Claude to search and retrieve meeting information through natural language queries.

🎯 Features

• 🔍 Smart Search: Natural language search across meeting titles, summaries, transcripts, and action items

• 📋 List Meetings: Retrieve meetings with various filters (attendees, date ranges, teams, etc.)

• 📝 Transcript Support: Optionally include full meeting transcripts in search results

• ⚡ Real-time: Direct integration with Fathom's API for up-to-date meeting data

• 🛡️ Secure: API key management through environment variables

Related MCP server: Fathom MCP Server

🚀 Quick Start

Prerequisites

• Node.js 18 or higher

• npm or yarn

• A Fathom AI account with API access

• Claude Desktop app

Installation

1. Clone and setup:

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

2. Configure your API key:

cp .env.example .env
# Edit .env and add your Fathom API key

3. Get your Fathom API key:

   • Log in to Fathom

   • Go to Settings → API

   • Generate a new API key

   • Copy it to your .env file

4. Add to Claude Desktop:

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

5. Restart Claude Desktop and you're ready to go! 🎉

💬 Usage Examples

Once configured, you can ask Claude natural language questions about your meetings:

"Find me meetings about recruiting"
"Show me all external meetings from last week"  
"Search for meetings where we discussed product launches"
"List meetings with john@example.com"
"Find meetings with action items about hiring"
"What did we discuss in our Q1 planning meetings?"

Claude will automatically choose the right tool and search method based on your query.

🔧 Available Tools

list_meetings

Retrieves meetings with optional filters:

• calendar_invitees: Filter by attendee emails

• calendar_invitees_domains: Filter by company domains

• created_after/created_before: Date range filters

• meeting_type: all, internal, or external

• include_transcript: Include full transcripts

• recorded_by: Filter by meeting owner

• teams: Filter by team names

search_meetings

Searches meetings by keywords:

• search_term: The keyword/phrase to search for

• include_transcript: Search within transcripts (slower but more comprehensive)

🛠️ Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector dist/index.js

🐛 Troubleshooting

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

🙋‍♀️ Support

If you encounter any issues:

1. Check the troubleshooting section

2. Search existing GitHub issues

3. Create a new issue with detailed information about your problem

Status: Tested and working with GitHub integration ✓

Built for fun by @petesena ❤️