mcp-fathom-server by sourcegate - MCP Server

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

🚀 Quick Start

Prerequisites

Node.js 18 or higher
npm or yarn
A Fathom AI account with API access
Claude Desktop app

Installation

Clone and setup:

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

Configure your API key:

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

Get your Fathom API key:
- Log in to Fathom
- Go to Settings → API
- Generate a new API key
- Copy it to your .env file
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"
      }
    }
  }
}

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

Issue	Solution
Server won't start	Check that your API key is correctly set
No results found	Try broader search terms or check your API key permissions
Rate limiting	The server handles this automatically - wait a moment and try again
Claude can't find tools	Ensure Claude Desktop is restarted after config changes

📄 License

MIT License - see 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:

Check the troubleshooting section
Search existing GitHub issues
Create a new issue with detailed information about your problem

Built for fun by @petesena ❤️