@mindstone/mcp-server-fathom

List and search meetings, view details, read transcripts, and manage teams via Fathom AI.

Local-only Fathom MCP. Not the official server — built before Fathom shipped theirs; tokens stay on disk and each release goes through our own security review.

Status

• Version: 0.2.3 · npm
• Auth: API key (FATHOM_API_KEY)
• Tools: 7 (meetings, transcripts, teams)
• Surface: cloud-api
• Hosts tested: Claude Desktop, Cursor, Mindstone Rebel
• Machine-readable: STATUS.json

Why this exists

When we built this in early 2026, Fathom had not published an official MCP server, and the community options available at the time were thin and unmaintained — they listed meetings, but did not cover the team and transcript data our meeting-notes workflows depend on. We wrote our own so that any MCP host could pull Fathom transcripts and meeting details with the same credential handling, timeouts, and safety wrapping we apply across the rest of this repository. Fathom has since released an official MCP server; we continue to maintain this one because it runs locally on the user's machine and goes through our own security review before each release.

Example interaction

"Pull yesterday's Q3 planning meeting from Fathom and list the action items from the transcript."

Tools the host calls:

1. list_fathom_meetings — filtered by date range, finds the meeting and returns its ID.
2. get_fathom_transcript — fetches the transcript for that meeting ID.

Response (trimmed):

{
  "meeting": {
    "id": "mtg_01HXX...",
    "title": "Q3 planning",
    "scheduled_start": "2026-05-18T15:00:00Z"
  },
  "transcript": [
    { "t": "00:02", "speaker": "Alice", "text": "First topic is hiring..." },
    { "t": "00:47", "speaker": "Bob",   "text": "Let's lock the JD by Friday." }
  ]
}

Requirements

• Node.js 20+
• npm

One-click install

After clicking the button, your host will prompt you to fill: FATHOM_API_KEY.

{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-fathom"
      ],
      "env": {
        "FATHOM_API_KEY": ""
      }
    }
  }
}

Quick Start

Install & build

cd <path-to-repo>/connectors/fathom
npm install
npm run build

npx (once published)

npx -y @mindstone/mcp-server-fathom

Local

node dist/index.js

Configuration

Environment variables

• FATHOM_API_KEY — Fathom API key (from fathom.video settings)
• MCP_HOST_BRIDGE_STATE — optional path to a host bridge state file used for credential management
• MINDSTONE_REBEL_BRIDGE_STATE — backwards-compatible alias for MCP_HOST_BRIDGE_STATE

Host configuration examples

Claude Desktop / Cursor

{
  "mcpServers": {
    "Fathom": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-fathom"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

Local development (no npm publish needed)

{
  "mcpServers": {
    "Fathom": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/fathom/dist/index.js"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

Tools (7)

Configuration

• configure_fathom_api_key — Configure the Fathom API key

Meetings

• list_fathom_meetings — List meetings with server-side filtering
• get_fathom_meeting — Get details for a single meeting
• get_fathom_transcript — Get the transcript for a meeting
• get_fathom_meeting_participants — List the participants of a meeting

Teams

• list_fathom_teams — List all accessible teams
• list_fathom_team_members — List members of a specific team

Licence

FSL-1.1-MIT — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-04-08.