Skip to main content

MCP server for the Fathom AI meeting intelligence API

Project description

Fathom MCP Server

An MCP server for the Fathom AI meeting intelligence API, built with FastMCP.

Responses are optimized for LLM consumption -- compact plaintext instead of raw JSON, with playback URLs stripped and transcripts chunked by time window.

Tools

Tool Description
list_meetings List meetings with filtering by date, team, domain, participant, and pagination
get_transcript Get transcript for a recording, with optional time-window chunking (start_time/end_time)
get_summary Get the AI-generated summary for a recording (clean markdown, no playback URLs)
list_teams List all teams
list_team_members List team members, optionally filtered by team

All list tools support page and page_size params with random page access (no sequential fetching required). Use participants on list_meetings to filter by user email.

Prerequisites

  1. Install uv:
# macOS (recommended -- required for Claude Desktop compatibility)
brew install uv

# Linux / other
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Get a Fathom API key: go to Fathom Settings > API Access > Add + > Generate API Key.

Quick Start

No cloning or installing required. Just add the server to your MCP client config.

Claude Code

claude mcp add Fathom -e FATHOM_API_KEY=your-api-key -- uvx fathom-ai-mcp

Cursor / Windsurf

Add to your MCP config file:

  • Cursor: .cursor/mcp.json in your project root
  • Windsurf: ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "Fathom": {
      "command": "uvx",
      "args": ["fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop

Download the .mcpb file from the latest release and open it -- Claude Desktop will install the server and prompt for your API key.

Alternatively, add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "Fathom": {
      "command": "uvx",
      "args": ["fathom-ai-mcp"],
      "env": {
        "FATHOM_API_KEY": "your-api-key"
      }
    }
  }
}

Note: Claude Desktop requires uvx to be in a standard system path. On macOS, install uv via Homebrew (brew install uv) to ensure compatibility.

Environment Variables

Variable Required Default Description
FATHOM_API_KEY Yes - Your Fathom API key
FATHOM_TIMEOUT No 30 HTTP request timeout in seconds

Development

git clone https://github.com/jerichosequitin/fathom-ai-mcp.git
cd fathom-ai-mcp
uv sync
uv run server.py

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fathom_ai_mcp-0.1.5.tar.gz (7.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fathom_ai_mcp-0.1.5-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file fathom_ai_mcp-0.1.5.tar.gz.

File metadata

  • Download URL: fathom_ai_mcp-0.1.5.tar.gz
  • Upload date:
  • Size: 7.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fathom_ai_mcp-0.1.5.tar.gz
Algorithm Hash digest
SHA256 c020691bec401128307668e3c05cadcfb53f77a54eaf2cb35b4b146850160efc
MD5 16fe6d1756b25a28f5a816048715ad61
BLAKE2b-256 d837c2d0130d2c8b24acd1b748c4fb1fdf7fd031eef63453c4b6671fc7fafd61

See more details on using hashes here.

File details

Details for the file fathom_ai_mcp-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: fathom_ai_mcp-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 10.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for fathom_ai_mcp-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 f0ff82f8cd9a2911feaa085145457a64ea1d5f6015e90d77354ec251c91daaa8
MD5 703e69d0c134c23cdb1a45c0b356d571
BLAKE2b-256 d00393bc1984e5cb2275168043da39b4d3bbc2060caae4e3ea7b808db9a526fb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page