Fathom Simple

A Model Context Protocol (MCP) server for accessing Fathom AI API endpoints (meetings, recordings, transcripts, summaries, teams, team members) via GET operations.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "druellan-fathom-simple-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "OUTPUT_FORMAT": "toon",
        "FATHOM_API_KEY": "<api-key>",
        "FATHOM_TIMEOUT": "30",
        "DEFAULT_PER_PAGE": "50"
      }
    }
  }
}

You can access Fathom meeting data through an MCP server that exposes meetings, transcripts, summaries, teams, and team members. It is designed for efficiency and simplicity, using a compact output format to optimize interactions with large language models.

How to use

Use an MCP client to connect to the Fathom MCP Server and perform common data operations. You can search for meetings by keyword, list meetings with optional filters, and retrieve detailed meeting data that includes AI-generated summaries and transcripts. You can also list teams and team members, filtering as needed. Engines that consume MCP endpoints will receive structured results suitable for further processing, summarization, or decision making.

How to install

Prerequisites: Python 3.10+ and a valid Fathom API key.

Clone or download the MCP server package.
Install dependencies.

pip install -r requirements.txt

# Alternative local environment setup if you prefer venv
python -m venv venv
source venv/bin/activate  # on Unix/macOS
venv\Scripts\activate     # on Windows
pip install -r requirements.txt

Run the MCP server with your API key.

export FATHOM_API_KEY=your-api-key
python server.py

Additional configuration and usage notes

Configuration uses environment variables to control runtime behavior.

Environment variables you will typically set include:

FATHOM_API_KEY=your-api-key  # required
FATHOM_TIMEOUT=30            # request timeout in seconds (default: 30)
OUTPUT_FORMAT=toon            # output format: toon or json (default: toon)
DEFAULT_PER_PAGE=50           # results per page (default: 50)

Security and reliability

API keys are provided via environment variables and are not logged.
All requests use HTTPS to protect data in transit.
Error messages are designed to avoid exposing sensitive internal details and are logged with appropriate severity.

Available tools and data actions

The MCP server exposes the following capabilities to retrieve and analyze Fathom data.

Troubleshooting and notes

If you encounter authorization or rate-limit errors, verify that your FATHOM_API_KEY is correct and that the key has the necessary permissions. Check the timeout setting if you experience slow responses, and ensure network access to the MCP server is allowed.

Available tools

list_meetings

Retrieve meetings with optional filtering and pagination. Supports filters like calendar invites, creator, teams, and per-page pagination.

search_meetings

Search meetings by keyword across titles, attendees, teams, topics, and summaries. Can optionally search transcripts for matches.

get_meeting_details

Retrieve comprehensive meeting details including summary and metadata. Excludes the full transcript by default.

get_meeting_transcript

Retrieve the meeting transcript with essential metadata and timestamps.

list_teams

Retrieve all teams with optional pagination.

list_team_members

Retrieve team members with optional filtering by team and pagination.

Built by

VeilStrat

AI signals for GTM teams