get_meeting_details

Retrieve meeting summaries and metadata from Fathom recordings using a recording ID. Access key details without full transcripts for efficient meeting review.

Instructions

Retrieve comprehensive meeting details including summary and metadata (without transcript).

Example: get_meeting_details([recording_id])

Input Schema

TableJSON Schema

Name	Required	Description	Default
`recording_id`	Yes	The recording identifier

Implementation Reference

tools/recordings.py:8-63 (handler)

Core handler function that fetches meeting metadata and summary from Fathom API concurrently, strips markdown from summary, constructs a unified dictionary response excluding the transcript, and handles errors with context logging.

async def get_meeting_details(
    ctx: Context,
    recording_id: int
) -> dict:
    """Retrieve comprehensive meeting details including summary and metadata (without transcript).

    Args:
        ctx: MCP context for logging
        recording_id: Numeric ID of the recording

    Returns:
        dict: Unified meeting object with metadata and summary (no transcript)
    """
    try:
        await ctx.info(f"Fetching meeting details for recording {recording_id}")

        # Fetch meeting metadata and summary concurrently
        meeting_task = client.get_meeting(recording_id)
        summary_task = client.get_summary(recording_id)

        meeting, summary = await asyncio.gather(meeting_task, summary_task)

        # Convert markdown summary to plain text
        markdown_summary = summary.get("summary", {}).get("markdown_formatted", "")
        plain_text_summary = strip_markdown.strip_markdown(markdown_summary) if markdown_summary else ""

        # Build unified meeting object without transcript
        result = {
            "recording_id": recording_id,
            "title": meeting.get("title"),
            "meeting_url": meeting.get("url"),
            "share_url": meeting.get("share_url"),
            "created_at": meeting.get("created_at"),
            "scheduled_start_time": meeting.get("scheduled_start_time"),
            "scheduled_end_time": meeting.get("scheduled_end_time"),
            "recording_start_time": meeting.get("recording_start_time"),
            "recording_end_time": meeting.get("recording_end_time"),
            "transcript_language": meeting.get("transcript_language"),
            "participants": meeting.get("participants", []),
            "recorded_by": meeting.get("recorded_by"),
            "teams": meeting.get("teams", []),
            "topics": meeting.get("topics", []),
            "sentiment": meeting.get("sentiment"),
            "crm_matches": meeting.get("crm_matches", []),
            "summary": plain_text_summary
        }

        await ctx.info("Successfully retrieved meeting details")
        return result

    except FathomAPIError as e:
        await ctx.error(f"Fathom API error: {e.message}")
        raise e
    except Exception as e:
        await ctx.error(f"Unexpected error fetching meeting details: {str(e)}")
        raise e

server.py:155-165 (registration)

Registers the get_meeting_details tool with FastMCP using @mcp.tool decorator. Includes Pydantic Field for input validation/schema (recording_id), docstring, and delegates to the core implementation in tools.recordings.get_meeting_details.

@mcp.tool
async def get_meeting_details(
    ctx: Context,
    recording_id: int = Field(..., description="The recording identifier")
) -> Dict[str, Any]:
    """Retrieve comprehensive meeting details including summary and metadata (without transcript).

    Example:
        get_meeting_details([recording_id])
    """
    return await tools.recordings.get_meeting_details(ctx, recording_id)

server.py:158-159 (schema)
Pydantic input schema definition for the recording_id parameter using Field with required and description.
```
    recording_id: int = Field(..., description="The recording identifier")
) -> Dict[str, Any]:
```

Fathom-Simple-MCP