DF

dot-fun/fathom-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

14 stars 10 forks 质量 70 趋势 20MIT

Model Context Protocol server for Fathom AI - access meeting recordings, transcripts, summaries, teams, and webhooks

概览

A Model Context Protocol (MCP) server for interacting with the Fathom AI API. This server provides tools for accessing meeting recordings, summaries, transcripts, teams, and webhooks. - : List meetings with advanced filtering (by participants, date ranges, teams) and optional inclusion of transcripts, summaries, action items, and CRM matches - : Retrieve meeting summaries (supports async delivery) - : Retrieve meeting transcripts with speaker information and timestamps (supports async delivery) - : List all accessible teams - : List team members with optional team filtering - : Create webhooks for meeting notifications with customizable triggers and content inclusion - : Delete webhooks by ID - : API information and available endpoints - : Rate limiting information and best practices 1. Clone this repository or copy the files to your local machine 2. Install dependencies using uv (recommended) or pip: The server auto-loads .env for local usage.

README

以下为原文 README 节选,完整内容请查看原文。

Fathom AI MCP Server

A Model Context Protocol (MCP) server for interacting with the Fathom AI API. This server provides tools for accessing meeting recordings, summaries, transcripts, teams, and webhooks.

Quick Start

git clone https://github.com/Dot-Fun/fathom-mcp.git
cd fathom-mcp
uv pip install fastmcp httpx pydantic
export FATHOM_API_KEY="your_api_key_here"
fastmcp run server.py

Features

Tools

  • list_meetings: List meetings with advanced filtering (by participants, date ranges, teams) and optional inclusion of transcripts, summaries, action items, and CRM matches
  • get_summary: Retrieve meeting summaries (supports async delivery)
  • get_transcript: Retrieve meeting transcripts with speaker information and timestamps (supports async delivery)
  • list_teams: List all accessible teams
  • list_team_members: List team members with optional team filtering
  • create_webhook: Create webhooks for meeting notifications with customizable triggers and content inclusion
  • delete_webhook: Delete webhooks by ID

Resources

  • fathom://api/info: API information and available endpoints
  • fathom://api/rate-limits: Rate limiting information and best practices

Installation

  1. Clone this repository or copy the files to your local machine

  2. Install dependencies using uv (recommended) or pip:

# Using uv (recommended)
uv pip install -e .

# Or using pip
pip install -e .
  1. Set up your Fathom API key:

Create a .env file in the project root:

FATHOM_API_KEY=your_api_key_here

The server auto-loads .env for local usage.

Get your API key from the Fathom settings page.

Usage

Running the Server

Local Development (stdio)

# Using fastmcp CLI
fastmcp run server.py

# Or directly with Python
python server.py

HTTP Server

# Modify server.py to run as HTTP server
if __name__ == "__main__":
    mcp.run(transport="http", host="0.0.0.0", port=8000)

Integrating with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "fathom": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/fathom-mcp",
        "run",
        "fastmcp",
        "run",
        "server.py"
      ],
      "env": {
        "FATHOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Integrating with Codex (alternative)

Add this block to your Codex config (~/.codex/config.toml):

[mcp_servers.fathom]
command = "uv"
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "fathom": { "command": "uv", "args": [ "--directory", "/path/to/fathom-mcp", "run", "fastmcp", "run", "server.py" ], "env": { "FATHOM_API_KEY": "your_api_key_here" } } } }