fathom-ai-mcp
v1.1.1
Published
MCP server for the Fathom AI meeting intelligence API
Readme
Fathom AI MCP Server
An MCP (Model Context Protocol) server that exposes the Fathom AI meeting intelligence API as tools for Claude. List meetings, fetch transcripts and summaries, and browse teams and members directly from Claude.
This is an unofficial community project, not affiliated with Fathom.
Tools
| Tool | Description |
|------|-------------|
| list_meetings | List meetings with filters (date range, recorder, teams, domains) |
| get_meeting_summary | Get the summary for a specific recording |
| get_meeting_transcript | Get the transcript for a specific recording |
| list_teams | List all teams in the organization |
| list_team_members | List team members, optionally filtered by team |
All list endpoints support cursor-based pagination.
Setup
Prerequisites
- A Fathom AI API key (get one from your Fathom account settings)
- Node.js 18+ (for local/stdio mode only — not needed for remote HTTP mode)
Option 1: Quick start via npx (Claude Code)
claude mcp add fathom -- npx -y fathom-ai-mcp --api-key your-api-keyOption 2: Remote HTTP server (Claude Desktop / Cowork)
Deploy the server centrally (Docker/Kubernetes) so users don't need Node.js installed. Each user passes their own Fathom API key via the X-Fathom-Api-Key header.
Run with Docker
docker build -t fathom-ai-mcp .
docker run -p 3000:3000 fathom-ai-mcpConfigure in Claude Desktop
{
"mcpServers": {
"fathom": {
"url": "https://your-internal-host/mcp",
"headers": {
"X-Fathom-Api-Key": "your-api-key"
}
}
}
}Server options
# Default: stdio mode
fathom-ai-mcp --api-key your-key
# HTTP mode on custom port
fathom-ai-mcp --transport http --port 8080Option 3: Install from source
git clone [email protected]:apspan/fathom-ai-mcp.git
cd fathom-ai-mcp
npm install
npm run buildThen configure with the absolute path:
{
"mcpServers": {
"fathom": {
"command": "node",
"args": ["/absolute/path/to/fathom-ai-mcp/dist/index.js"],
"env": {
"FATHOM_API_KEY": "your-api-key"
}
}
}
}Usage examples
Once configured, ask Claude things like:
- "List my recent Fathom meetings"
- "Get the transcript for recording 12345"
- "Summarize my meeting from yesterday"
- "Show me all team members"
API reference
This server wraps the Fathom External API v1. Authentication uses the X-Api-Key header.
Transport modes
| Mode | Flag | Auth | Use case |
|------|------|------|----------|
| stdio (default) | --transport stdio | --api-key or FATHOM_API_KEY env var | Claude Code, local development |
| HTTP | --transport http | X-Fathom-Api-Key request header | Remote deployment, Claude Desktop, Cowork |
