teams-transcripts 0.5.0__py3-none-any.whl

teams_transcripts/mcp_server.py

@@ -0,0 +1,818 @@
+"""FastMCP STDIO server exposing Teams transcript extraction as typed tools.
+
+This module wraps the ``teams-transcripts`` CLI as MCP tools, callable
+by any MCP client (Claude Desktop, Cursor, OpenCode, etc.) over STDIO.
+
+Architecture:
+    Each tool builds a CLI command list, shells out via ``asyncio.subprocess``,
+    and returns the parsed JSON result.  The subprocess approach provides:
+    - Process isolation (Teams CDP locks are per-process)
+    - Clean signal handling (the child handles its own SIGINT/SIGTERM)
+    - No import-time side effects in the MCP server process
+
+Environment:
+    The MCP server inherits environment variables for GCP configuration:
+    - GOOGLE_CLOUD_PROJECT (required for download tools)
+    - CLOUD_ML_REGION (optional, default: global)
+    - MODEL_ID (optional, default: claude-haiku-4-5)
+    - GOOGLE_ADC (optional)
+    - TEAMS_TENANT (optional)
+
+Usage::
+
+    # Start the MCP server (STDIO transport)
+    teams-transcripts-mcp
+
+    # Or run as a module
+    python -m teams_transcripts.mcp_server
+
+Schema version: 3.0.0
+Created: 2026-04-27
+Updated: 2026-05-02
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import sys
+from uuid import UUID
+
+from mcp.server.fastmcp import FastMCP
+
+from teams_transcripts.adapters.cdp.teams import RestartBlockedError, restart_teams_process
+from teams_transcripts.domain.models import DownloadInput
+from teams_transcripts.infrastructure.logging import Logger
+from teams_transcripts.infrastructure.signals import ShutdownCoordinator
+
+# ---------------------------------------------------------------------------
+# Server definition
+# ---------------------------------------------------------------------------
+
+mcp = FastMCP(
+    "teams-transcripts",
+    instructions=(
+        "Tools for extracting Microsoft Teams meeting transcripts, chat messages, "
+        "and participant metadata.  Requires the Teams desktop app to be running "
+        "with CDP enabled on port 9333.  All tools return structured JSON.\n\n"
+        "Prefer these MCP tools over direct CLI invocation: they provide typed "
+        "parameters and pre-validation before invoking the CLI.\n\n"
+        "Recommended workflow:\n"
+        "1. Call list_transcripts() to discover available meetings and their IDs\n"
+        "2. Call download(call_id=...) for recurring meetings (uniquely identifies "
+        "a specific occurrence), or download(meeting_id=UUID) for non-recurring "
+        "meetings -- the unified entry point that validates arguments before "
+        "launching the subprocess\n\n"
+        "Alternative (specialised) tools are available when you only need a "
+        "subset of data (e.g. download_transcript_by_meeting_id).  All download "
+        "tools accept dry_run=True to verify a meeting can be found without "
+        "performing transcript download, chat extraction, or Details tracking.\n\n"
+        "Argument constraints (enforced by download() pre-validation):\n"
+        "- meeting_id, call_id, and meeting are mutually exclusive\n"
+        "- date and time are incompatible with meeting_id and call_id\n"
+        "- At least one of transcript/chat/metadata must be True, except "
+        "with dry_run=True for a pure meeting-exists check\n\n"
+        "For multi-tenant environments, call list_tenants() first to discover "
+        "available tenants, then pass the tenant domain to other tools.\n\n"
+        "Automatic Teams restarts fail closed when a live call is active or its "
+        "state cannot be determined. If a tool reports RESTART_BLOCKED, do not "
+        "retry destructively. restart_teams(force=True) may be used only after "
+        "the user explicitly requests interruption of a possible live call."
+    ),
+)
+
+
+# ---------------------------------------------------------------------------
+# Internal helpers
+# ---------------------------------------------------------------------------
+
+
+def _find_cli_executable() -> str:
+    """Resolve the CLI executable path.
+
+    Prefers the installed entry point; falls back to ``python -m`` invocation.
+    """
+    import shutil
+
+    exe = shutil.which("teams-transcripts")
+    if exe:
+        return exe
+    # Fallback: use the same Python interpreter to run the module
+    return ""
+
+
+def _validate_port(port: int) -> None:
+    """Validate a TCP port value for MCP tool inputs."""
+    if not 1 <= port <= 65535:
+        raise ValueError("port must be between 1 and 65535.")
+
+
+async def _run_cli(args: list[str], timeout: int = 600) -> dict:
+    """Execute the CLI subprocess and return parsed JSON output.
+
+    Args:
+        args: CLI arguments (excluding the executable itself).
+        timeout: Maximum seconds to wait for the subprocess.
+
+    Returns:
+        Parsed JSON dict from stdout.
+
+    Raises:
+        RuntimeError: If the subprocess fails or produces invalid JSON.
+    """
+    exe = _find_cli_executable()
+    cmd = [exe, *args] if exe else [sys.executable, "-m", "teams_transcripts", *args]
+
+    proc = await asyncio.create_subprocess_exec(
+        *cmd,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+    )
+
+    try:
+        stdout, stderr = await asyncio.wait_for(
+            proc.communicate(),
+            timeout=timeout,
+        )
+    except asyncio.TimeoutError as exc:
+        proc.kill()
+        await proc.communicate()
+        raise RuntimeError(f"CLI timed out after {timeout}s. Args: {args}") from exc
+
+    stdout_text = stdout.decode("utf-8", errors="replace").strip()
+    stderr_text = stderr.decode("utf-8", errors="replace").strip()
+
+    if proc.returncode != 0:
+        # Try to parse error JSON from stdout (CLI emits structured errors)
+        if stdout_text:
+            try:
+                error_data = json.loads(stdout_text)
+                code = error_data.get("code", "UNKNOWN")
+                msg = error_data.get("message", stderr_text or "Unknown error")
+                raise RuntimeError(f"[{code}] {msg} (exit {proc.returncode})")
+            except json.JSONDecodeError:
+                pass
+        raise RuntimeError(
+            f"CLI failed (exit {proc.returncode}): {stderr_text or stdout_text or 'no output'}"
+        )
+
+    if not stdout_text:
+        raise RuntimeError("CLI produced no output on stdout")
+
+    try:
+        return json.loads(stdout_text)
+    except json.JSONDecodeError as e:
+        raise RuntimeError(
+            f"CLI produced invalid JSON: {e}. First 200 chars: {stdout_text[:200]}"
+        ) from e
+
+
+async def _run_cli_list(args: list[str], timeout: int = 120) -> list:
+    """Execute the CLI subprocess and return parsed JSON list output.
+
+    Like ``_run_cli`` but expects a JSON array (used by list commands).
+    """
+    exe = _find_cli_executable()
+    cmd = [exe, *args] if exe else [sys.executable, "-m", "teams_transcripts", *args]
+
+    proc = await asyncio.create_subprocess_exec(
+        *cmd,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+    )
+
+    try:
+        stdout, stderr = await asyncio.wait_for(
+            proc.communicate(),
+            timeout=timeout,
+        )
+    except asyncio.TimeoutError as exc:
+        proc.kill()
+        await proc.communicate()
+        raise RuntimeError(f"CLI timed out after {timeout}s. Args: {args}") from exc
+
+    stdout_text = stdout.decode("utf-8", errors="replace").strip()
+    stderr_text = stderr.decode("utf-8", errors="replace").strip()
+
+    if proc.returncode != 0:
+        if stdout_text:
+            try:
+                error_data = json.loads(stdout_text)
+                code = error_data.get("code", "UNKNOWN")
+                msg = error_data.get("message", stderr_text or "Unknown error")
+                raise RuntimeError(f"[{code}] {msg} (exit {proc.returncode})")
+            except json.JSONDecodeError:
+                pass
+        raise RuntimeError(
+            f"CLI failed (exit {proc.returncode}): {stderr_text or stdout_text or 'no output'}"
+        )
+
+    if not stdout_text:
+        raise RuntimeError("CLI produced no output on stdout")
+
+    try:
+        return json.loads(stdout_text)
+    except json.JSONDecodeError as e:
+        raise RuntimeError(
+            f"CLI produced invalid JSON: {e}. First 200 chars: {stdout_text[:200]}"
+        ) from e
+
+
+def _base_args(
+    meeting: str,
+    date: str,
+    *,
+    time: str | None = None,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> list[str]:
+    """Build common CLI arguments for meeting-download tools (name-based)."""
+    _validate_port(port)
+    args = [
+        "--meeting",
+        meeting,
+        "--datetime",
+        f"{date}T{time}" if time else date,
+        "--format",
+        "json",
+        "--quiet",
+        "--port",
+        str(port),
+    ]
+    if tenant:
+        args.extend(["--tenant", tenant])
+    if dry_run:
+        args.append("--dry-run")
+    return args
+
+
+def _base_args_by_id(
+    meeting_id: str,
+    *,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> list[str]:
+    """Build common CLI arguments for meeting-download tools (UUID-based)."""
+    meeting_id = str(UUID(meeting_id))
+    _validate_port(port)
+    args = [
+        "--meeting-id",
+        meeting_id,
+        "--format",
+        "json",
+        "--quiet",
+        "--port",
+        str(port),
+    ]
+    if tenant:
+        args.extend(["--tenant", tenant])
+    if dry_run:
+        args.append("--dry-run")
+    return args
+
+
+def _base_args_by_call_id(
+    call_id: str,
+    *,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> list[str]:
+    """Build common CLI arguments for meeting-download tools (call-ID-based)."""
+    if not call_id or not call_id.strip():
+        raise ValueError("call_id must be a non-empty string.")
+    _validate_port(port)
+    args = [
+        "--call-id",
+        call_id,
+        "--format",
+        "json",
+        "--quiet",
+        "--port",
+        str(port),
+    ]
+    if tenant:
+        args.extend(["--tenant", tenant])
+    if dry_run:
+        args.append("--dry-run")
+    return args
+
+
+# ---------------------------------------------------------------------------
+# MCP Tools -- Discovery
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+def restart_teams(port: int = 9333, force: bool = False) -> dict:
+    """Safely restart Teams with CDP enabled and report readiness.
+
+    The restart is blocked when a live call is detected or call state cannot
+    be established. Agents must set ``force=True`` only after the user
+    explicitly requests interruption of a possible live call.
+
+    Args:
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        force: Bypass the call safeguard after explicit user approval.
+    """
+    _validate_port(port)
+    logger = Logger(quiet=True)
+    shutdown = ShutdownCoordinator(format_json=True)
+    try:
+        result = restart_teams_process(
+            port,
+            logger=logger,
+            shutdown=shutdown,
+            force=force,
+        )
+    except RestartBlockedError as error:
+        return {
+            "status": "blocked",
+            "restarted": False,
+            "cdp_ready": False,
+            "port": port,
+            "call_state": error.call_state.value,
+            "reason": error.reason,
+            "forced": force,
+        }
+    response = result.to_dict()
+    if not result.cdp_ready:
+        response["reason"] = "cdp_timeout"
+    return response
+
+
+@mcp.tool()
+async def list_tenants(
+    port: int = 9333,
+) -> list:
+    """List available Azure AD tenants the signed-in Teams user can access.
+
+    Returns an array of tenant objects with name, primary domain, tenant ID,
+    and whether it is the currently active tenant.  Use a tenant domain value
+    with the 'tenant' parameter in other tools to ensure the correct tenant
+    is active.
+
+    Args:
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+    """
+    _validate_port(port)
+    args = ["--list-tenants", "--format", "json", "--quiet", "--port", str(port)]
+    return await _run_cli_list(args, timeout=120)
+
+
+@mcp.tool()
+async def list_transcripts(
+    days: int = 7,
+    tenant: str | None = None,
+    port: int = 9333,
+) -> list:
+    """List meetings with transcripts available for download.
+
+    Queries the Teams MCPS API to discover meetings that have transcripts
+    within the specified time range.  Returns an array of meeting objects,
+    each containing subject, date, thread_id, has_transcript, has_recording,
+    and transcript/recording URLs.
+
+    The meeting ID (UUID) from each result can be passed to
+    download_by_meeting_id() for unambiguous transcript extraction.
+
+    Without a tenant specified, aggregates results across all signed-in tenants.
+
+    Args:
+        days: Number of days to look back (default: 7, must be >= 1; max recommended: 90).
+        tenant: Azure AD tenant domain to query (e.g. 'contoso.com').
+              Without this, aggregates across all signed-in tenants.
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+    """
+    if days < 1:
+        raise ValueError("days must be 1 or greater.")
+    _validate_port(port)
+    args = [
+        "--list-transcripts",
+        str(days),
+        "--format",
+        "json",
+        "--quiet",
+        "--port",
+        str(port),
+    ]
+    if tenant:
+        args.extend(["--tenant", tenant])
+    return await _run_cli_list(args, timeout=120)
+
+
+# ---------------------------------------------------------------------------
+# MCP Tools -- Unified download (recommended entry point)
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def download(
+    meeting_id: str | None = None,
+    call_id: str | None = None,
+    meeting: str | None = None,
+    date: str | None = None,
+    time: str | None = None,
+    transcript: bool = True,
+    chat: bool = True,
+    metadata: bool = True,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Unified download tool -- the recommended entry point for AI agents.
+
+    Accepts EITHER a call_id (best for recurring meetings), a meeting UUID,
+    OR a meeting name + date.  Pre-validates argument combinations before
+    launching the CLI subprocess, giving immediate clear errors rather than
+    a delayed subprocess failure.
+
+    Prefer call_id for recurring meetings (uniquely identifies the specific
+    occurrence).  Use meeting_id for non-recurring meetings.  Fall back to
+    meeting + date when neither ID is available.
+
+    At least one of transcript, chat, or metadata must be True, except when
+    dry_run is True for a pure meeting-exists check.
+
+    Args:
+        meeting_id: Meeting UUID (from list_transcripts ID column).  Mutually
+                   exclusive with call_id and meeting/date/time.
+        call_id: Call identifier (from list_transcripts Call ID column).
+                Uniquely identifies a specific occurrence; preferred for
+                recurring meetings.  Mutually exclusive with meeting_id and
+                meeting/date/time.
+        meeting: Meeting name as it appears in Teams search results.
+                Required when neither meeting_id nor call_id is provided.
+        date: Meeting date in YYYY-MM-DD format.  Required when using
+             meeting (defaults to today if omitted).  Incompatible with
+             meeting_id and call_id (date is resolved automatically).
+        time: Optional start time in HH:MM format to disambiguate same-day
+             meetings.  Only valid with meeting, not meeting_id or call_id.
+        transcript: Whether to download the transcript (default: True).
+        chat: Whether to download chat messages (default: True).
+        metadata: Whether to download participant metadata (default: True).
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify navigation and requested safe metadata but skip
+                transcript download, chat/attendance extraction, and Details tracking.
+                Allows transcript=False, chat=False, metadata=False.
+
+    Returns:
+        Structured JSON with the requested data (transcript cues, chat
+        messages, and/or participant metadata).
+
+    Raises:
+        ValueError: If argument combinations are invalid.
+    """
+    # -- Pre-subprocess validation via Pydantic model -----------------------
+    try:
+        DownloadInput(
+            meeting_id=meeting_id,
+            call_id=call_id,
+            meeting=meeting,
+            date=date,
+            time=time,
+            include_transcript=transcript,
+            include_chat=chat,
+            include_metadata=metadata,
+            dry_run=dry_run,
+        )
+    except Exception as exc:
+        # Re-raise as ValueError for a stable MCP interface -- FastMCP
+        # converts ValueError to a structured error response.
+        raise ValueError(str(exc)) from exc
+
+    # -- Build CLI args -----------------------------------------------------
+    _yes_no = lambda b: "yes" if b else "no"  # noqa: E731
+
+    if call_id:
+        args = _base_args_by_call_id(
+            call_id,
+            tenant=tenant,
+            port=port,
+            dry_run=dry_run,
+        )
+    elif meeting_id:
+        args = _base_args_by_id(
+            meeting_id,
+            tenant=tenant,
+            port=port,
+            dry_run=dry_run,
+        )
+    else:
+        assert meeting is not None  # validated above
+        args = _base_args(
+            meeting,
+            date or "",
+            time=time,
+            tenant=tenant,
+            port=port,
+            dry_run=dry_run,
+        )
+
+    args.extend(
+        [
+            "--transcript",
+            _yes_no(transcript),
+            "--chat",
+            _yes_no(chat),
+            "--metadata",
+            _yes_no(metadata),
+        ]
+    )
+    return await _run_cli(args, timeout=600)
+
+
+# ---------------------------------------------------------------------------
+# MCP Tools -- Download by meeting ID (UUID)
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def download_by_meeting_id(
+    meeting_id: str,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download transcript, chat, and metadata by meeting UUID.
+
+    This is the preferred download method when you have a meeting UUID
+    (from list_transcripts output).  It eliminates ambiguity when multiple
+    meetings share the same name.  The meeting subject and date are resolved
+    automatically from the UUID via the MCPS API.
+
+    Returns the same structured JSON as download_all (transcript cues,
+    chat messages, and participant metadata).
+
+    Args:
+        meeting_id: Meeting UUID (e.g. '2b4c1f5c-636d-4d78-a087-c2cbf3887fd8').
+                   Obtain this from list_transcripts() output.
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args_by_id(meeting_id, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "yes", "--chat", "yes", "--metadata", "yes"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_by_call_id(
+    call_id: str,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download transcript, chat, and metadata by call ID.
+
+    This is the preferred download method for recurring meetings.  The
+    call_id uniquely identifies a specific occurrence, eliminating the
+    ambiguity that arises when multiple occurrences share the same
+    meeting UUID (thread_id).
+
+    The meeting subject, date, and thread are resolved automatically
+    from the call ID via the MCPS API.
+
+    Args:
+        call_id: Call identifier (from list_transcripts() Call ID field).
+                Uniquely identifies a single meeting occurrence.
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args_by_call_id(call_id, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "yes", "--chat", "yes", "--metadata", "yes"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_transcript_by_meeting_id(
+    meeting_id: str,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download only the transcript (WebVTT cues) by meeting UUID.
+
+    Skips chat and metadata extraction for faster results.  The meeting
+    subject and date are resolved automatically from the UUID.
+
+    Args:
+        meeting_id: Meeting UUID (from list_transcripts output).
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args_by_id(meeting_id, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "yes", "--chat", "no", "--metadata", "no"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_chat_by_meeting_id(
+    meeting_id: str,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download only chat messages by meeting UUID.
+
+    Extracts all chat messages with timestamps, authors, text content,
+    and reactions.  Skips transcript download and participant metadata.
+
+    Args:
+        meeting_id: Meeting UUID (from list_transcripts output).
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args_by_id(meeting_id, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "no", "--chat", "yes", "--metadata", "no"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_metadata_by_meeting_id(
+    meeting_id: str,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download only participant metadata by meeting UUID.
+
+    Extracts categorised participant lists (organiser, invited with RSVP
+    status, speakers, attendees).  Skips transcript and chat extraction.
+
+    Args:
+        meeting_id: Meeting UUID (from list_transcripts output).
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args_by_id(meeting_id, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "no", "--chat", "no", "--metadata", "yes"])
+    return await _run_cli(args, timeout=600)
+
+
+# ---------------------------------------------------------------------------
+# MCP Tools -- Download by meeting name + date
+# ---------------------------------------------------------------------------
+
+
+@mcp.tool()
+async def download_all(
+    meeting: str,
+    date: str,
+    time: str | None = None,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download transcript, chat messages, and participant metadata for a meeting.
+
+    This is the most comprehensive extraction tool.  It downloads the full
+    transcript (WebVTT cues), all chat messages with timestamps and reactions,
+    and categorised participant lists (organiser, invited, speakers, attendees)
+    with RSVP status.
+
+    Use this when you know the meeting name and date.  For unambiguous lookup
+    by UUID, use download_by_meeting_id() instead.
+
+    Args:
+        meeting: Meeting name as it appears in Teams search results.
+        date: Meeting date in YYYY-MM-DD format.
+        time: Optional start time in HH:MM format to disambiguate same-day meetings.
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args(meeting, date, time=time, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "yes", "--chat", "yes", "--metadata", "yes"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_transcript(
+    meeting: str,
+    date: str,
+    time: str | None = None,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download only the transcript (WebVTT cues) for a meeting.
+
+    Skips chat and metadata extraction for faster results.  The returned
+    JSON includes structured transcript cue objects, speaker breakdown, and
+    cue count.
+
+    Args:
+        meeting: Meeting name as it appears in Teams search results.
+        date: Meeting date in YYYY-MM-DD format.
+        time: Optional start time in HH:MM format to disambiguate same-day meetings.
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args(meeting, date, time=time, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "yes", "--chat", "no", "--metadata", "no"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_chat(
+    meeting: str,
+    date: str,
+    time: str | None = None,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download only chat messages from a meeting.
+
+    Extracts all chat messages with timestamps, authors, text content,
+    and reactions.  Each message includes an offset from the meeting start
+    time.  Skips transcript download and participant metadata.
+
+    Args:
+        meeting: Meeting name as it appears in Teams search results.
+        date: Meeting date in YYYY-MM-DD format.
+        time: Optional start time in HH:MM format to disambiguate same-day meetings.
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args(meeting, date, time=time, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "no", "--chat", "yes", "--metadata", "no"])
+    return await _run_cli(args, timeout=600)
+
+
+@mcp.tool()
+async def download_meeting_metadata(
+    meeting: str,
+    date: str,
+    time: str | None = None,
+    tenant: str | None = None,
+    port: int = 9333,
+    dry_run: bool = False,
+) -> dict:
+    """Download only participant metadata for a meeting.
+
+    Extracts categorised participant lists:
+    - Organiser: meeting creator with email
+    - Invited: all invited members with RSVP status (accepted/tentative/declined)
+    - Speakers: members who spoke during the meeting
+    - Attendees: members who joined the call
+
+    Skips transcript download and chat extraction.
+
+    Args:
+        meeting: Meeting name as it appears in Teams search results.
+        date: Meeting date in YYYY-MM-DD format.
+        time: Optional start time in HH:MM format to disambiguate same-day meetings.
+        tenant: Azure AD tenant domain to verify/switch to (e.g. 'contoso.com').
+        port: CDP remote debugging port (default: 9333, range: 1..65535).
+        dry_run: If True, verify the meeting can be found but skip download.
+    """
+    args = _base_args(meeting, date, time=time, tenant=tenant, port=port, dry_run=dry_run)
+    args.extend(["--transcript", "no", "--chat", "no", "--metadata", "yes"])
+    return await _run_cli(args, timeout=600)
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+
+def main() -> None:
+    """Run the MCP server.
+
+    Supports STDIO (default) or SSE transport when --port is specified.
+    """
+    import argparse
+
+    p = argparse.ArgumentParser(
+        description="Teams Transcripts MCP server",
+    )
+    p.add_argument(
+        "--port",
+        type=int,
+        default=None,
+        metavar="PORT",
+        help="Run as an SSE server on this port instead of STDIO.",
+    )
+    args = p.parse_args()
+
+    if args.port:
+        _validate_port(args.port)
+        mcp.settings.port = args.port
+        mcp.run(transport="sse")
+    else:
+        mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()