Fathom MCP Server

List meetings from Fathom with optional filtering and pagination.

This tool retrieves meeting recordings from your Fathom account. You can filter by:

• Company domains of calendar invitees

• Internal vs external meetings

• Date range (created_after/created_before)

• Recorder email addresses

• Team names

You can optionally include:

• AI-generated summaries

• Full transcripts

• Action items

• CRM matches (contacts, companies, deals)

Args:

• calendar_invitees_domains (string[]): Filter by company domains

• calendar_invitees_domains_type ('all'|'only_internal'|'one_or_more_external'): Filter by meeting type

• created_after (string): ISO 8601 timestamp to filter meetings after

• created_before (string): ISO 8601 timestamp to filter meetings before

• cursor (string): Pagination cursor from previous response

• include_action_items (boolean): Include action items (default: false)

• include_crm_matches (boolean): Include CRM matches (default: false)

• include_summary (boolean): Include summaries (default: false)

• include_transcript (boolean): Include transcripts (default: false)

• recorded_by (string[]): Filter by recorder emails

• teams (string[]): Filter by team names

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns: Paginated list of meetings with requested details.

Examples:

• List recent meetings: {}

• External meetings only: { calendar_invitees_domains_type: 'one_or_more_external' }

• With summaries: { include_summary: true }

• Filter by team: { teams: ['Sales'] }

Get the AI-generated summary for a specific Fathom recording.

This tool retrieves the summary that Fathom automatically generates for each meeting. The summary includes key discussion points, decisions made, and important topics covered.

Args:

• recording_id (number, required): The ID of the recording to get the summary for

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns: The meeting summary with template name and formatted content.

Examples:

• Get summary: { recording_id: 123456789 }

• Get as JSON: { recording_id: 123456789, response_format: 'json' }

Notes:

• The recording_id can be found in the meeting list response

• Summaries are always in English regardless of the meeting's original language

Get the full transcript for a specific Fathom recording.

This tool retrieves the complete timestamped transcript of a meeting, including speaker identification and timestamps for each segment.

Args:

• recording_id (number, required): The ID of the recording to get the transcript for

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns: Array of transcript entries, each containing:

• speaker: Speaker name and optionally matched email

• text: What was said

• timestamp: When it was said (HH:MM:SS format)

Examples:

• Get transcript: { recording_id: 123456789 }

• Get as JSON: { recording_id: 123456789, response_format: 'json' }

Notes:

• Transcripts can be large for long meetings

• Speaker names are matched to calendar invitees when possible

• Timestamps are relative to the recording start time

List all teams accessible to the authenticated user in Fathom.

This tool retrieves the list of teams in your Fathom workspace. Teams are used to organize recordings and control access to meeting content.

Args:

• cursor (string): Pagination cursor from previous response

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns: Paginated list of teams with:

• name: Team name

• created_at: When the team was created

Examples:

• List all teams: {}

• Get as JSON: { response_format: 'json' }

• Next page: { cursor: 'eyJwYWdlX251bSI6Mn0=' }

List members of a specific team or all teams in Fathom.

This tool retrieves team member information including names, emails, and when they joined.

Args:

• team (string): Filter by team name (optional - shows all members if not specified)

• cursor (string): Pagination cursor from previous response

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns: Paginated list of team members with:

• name: Member's display name

• email: Member's email address

• created_at: When the member was added

Examples:

• List all members: {}

• Filter by team: { team: 'Sales' }

• Get as JSON: { response_format: 'json' }

Create a webhook to receive real-time notifications when meetings are processed in Fathom.

This tool creates a webhook subscription that will POST meeting data to your specified URL whenever new meeting content becomes available.

Args:

• destination_url (string, required): The URL to receive webhook notifications

• triggered_for (string[], required): At least one trigger type:

  • 'my_recordings': Your private recordings and those shared with individuals

  • 'shared_external_recordings': Recordings shared with you by external users

  • 'my_shared_with_team_recordings': Your recordings shared with teams

  • 'shared_team_recordings': Team recordings accessible to you

• include_action_items (boolean): Include action items in payload (default: false)

• include_crm_matches (boolean): Include CRM matches in payload (default: false)

• include_summary (boolean): Include meeting summary in payload (default: false)

• include_transcript (boolean): Include transcript in payload (default: false)

Returns: The created webhook details including:

• id: Webhook ID (use this for deletion)

• url: Destination URL

• secret: Webhook secret for signature verification

• created_at: Creation timestamp

Examples:

• Basic webhook: { destination_url: 'https://your-app.com/webhook', triggered_for: ['my_recordings'] }

• With all content: { destination_url: 'https://your-app.com/webhook', triggered_for: ['my_recordings', 'shared_team_recordings'], include_transcript: true, include_summary: true, include_action_items: true }

Notes:

• Webhooks use HMAC-SHA256 signatures for verification

• The secret is only shown once upon creation - save it securely

• Webhooks must return 2xx status to acknowledge receipt

Delete an existing webhook from Fathom.

This tool removes a webhook subscription, stopping all future notifications to that endpoint.

Args:

• id (string, required): The ID of the webhook to delete

Returns: Confirmation of successful deletion.

Examples:

• Delete webhook: { id: 'ikEoQ4bVoq4JYUmc' }

Notes:

• This action cannot be undone

• The webhook will immediately stop receiving notifications

• Any pending notifications may still be delivered

Search across Fathom meeting titles, transcripts, and summaries.

This tool performs a text search across your meeting content to find relevant discussions, mentions, or topics.

Args:

• query (string, required): Search string (2-200 characters)

• created_after (string): Filter to meetings after this ISO 8601 timestamp

• created_before (string): Filter to meetings before this ISO 8601 timestamp

• teams (string[]): Filter by team names

• limit (number): Max results to return (1-50, default: 10)

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns: Matching meetings with:

• Meeting details

• Where matches were found (title, transcript, summary)

• Context snippets showing the matched text

Examples:

• Search for topic: { query: 'quarterly budget' }

• With date filter: { query: 'product launch', created_after: '2024-01-01T00:00:00Z' }

• Limit results: { query: 'feature request', limit: 5 }

Notes:

• Search is case-insensitive

• Searches across transcripts and summaries (fetched automatically)

• Limited to most recent meetings for performance

Get analytics and statistics about your Fathom meetings.

This tool calculates aggregate statistics about your meetings including duration metrics, team breakdowns, and internal vs external meeting ratios.

Args:

• created_after (string): Filter to meetings after this ISO 8601 timestamp

• created_before (string): Filter to meetings before this ISO 8601 timestamp

• teams (string[]): Filter by team names

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns:

• total_meetings: Number of meetings analyzed

• duration_stats: Average, min, max, and total meeting duration in minutes

• meetings_by_team: Count of meetings per team

• internal_vs_external: Breakdown of internal vs external meetings

Examples:

• All time stats: {}

• This month: { created_after: '2024-11-01T00:00:00Z' }

• Sales team: { teams: ['Sales'] }

Notes:

• Duration is calculated from recording start to end time

• Team breakdown based on recorder's team

• External = one or more external participants

Get analytics about meeting participants and recorders in Fathom.

This tool analyzes who attends your meetings most frequently and which domains are most common.

Args:

• created_after (string): Filter to meetings after this ISO 8601 timestamp

• created_before (string): Filter to meetings before this ISO 8601 timestamp

• limit (number): Max top participants/recorders to return (1-100, default: 10)

• response_format ('markdown'|'json'): Output format (default: 'markdown')

Returns:

• top_participants: Most frequent meeting attendees

• domain_breakdown: Meeting count by email domain

• top_recorders: Users who record the most meetings

Examples:

• All time stats: {}

• Top 20: { limit: 20 }

• This quarter: { created_after: '2024-10-01T00:00:00Z' }