fathom
Model Context Protocol server for Fathom AI - access meeting recordings, transcripts, summaries, teams, and webhooks
claude mcp add --transport stdio dot-fun-fathom-mcp python server.py \ --env FATHOM_API_KEY="your_api_key_here"
How to use
Fathom MCP Server provides a Python-based interface to interact with the Fathom AI API via the MCP framework. It exposes tools to list meetings, retrieve summaries and transcripts, list teams and team members, and manage webhooks for meeting notifications. You can access these capabilities through the MCP tooling exposed by the server (e.g., list_meetings, get_summary, get_transcript, list_teams, list_team_members, create_webhook, delete_webhook). The server requires a FATHOM_API_KEY to authenticate with the Fathom API. Once running, you can call the MCP endpoints or use the provided examples in the README to issue requests and integrate with other tools or automations.
How to install
Prerequisites:
- Python 3.10+ installed
- Access to the internet to install dependencies
-
Clone the repository and navigate to the project directory: git clone https://github.com/Dot-Fun/fathom-mcp.git cd fathom-mcp
-
Install dependencies (recommended via uvx; shown here with Python in-editor usage): uv pip install -e .
or alternatively if you are using pip directly:
pip install -e .
-
Create and configure environment variables:
- Create a .env file in the project root or export the key in your shell: FATHOM_API_KEY=your_api_key_here
- Obtain your API key from the Fathom settings page.
-
Run the MCP server: python server.py
Alternatively, if you prefer the FastMCP orchestration:
fastmcp run server.py
-
(Optional) Run via Claude Desktop integration (example):
- Ensure your Claude Desktop config includes the fathom MCP server with the appropriate command and environment variables as shown in the README.
-
Verify the server is running by checking logs or hitting a test endpoint as described in the API section of the README.
Additional notes
Tips and tips:
- The server uses FATHOM_API_KEY for authentication. Ensure this key is kept secure and not committed to version control.
- If running HTTP, you can modify server.py to set transport to http and specify host/port as needed.
- The integration example shows using uv to install dependencies and simple Python invocation to run; you can adapt the command in mcp_config to uvx if you prefer uv-based execution.
- When deploying, consider containerizing with Docker as per the repository structure if you plan to run in production. Ensure environment variables are passed into the container (e.g., FATHOM_API_KEY).
- Familiarize yourself with the available tools in the Quick Start and API sections to craft complex queries (e.g., filtering meetings, including transcripts, summaries, action items, and CRM matches).
- For rate limits and error handling, respect the API limits and implement retries with backoff as needed.
Related MCP Servers
openapi
OpenAPI definitions, converters and LLM function calling schema composer.
python-notebook
Lightweight Python Notebook MCP - Enable AI assistants to create, edit, and view Jupyter notebooks via Model Context Protocol
apple-mail
MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails via natural language
docmole
Dig through any documentation with AI - MCP server for Claude, Cursor, and other AI assistants
skill-to
Convert AI Skills (Claude Skills format) to MCP server resources - Part of BioContextAI
obsidian
MCP server for Obsidian vault management - enables Claude and other AI assistants to read, write, search, and organize your notes