> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videodb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Call.md

> Turn meetings into live agent loops - real-time AI meeting assistant with dual-channel transcription and intelligent automation

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/n24NPxYofRc" title="Call.md - AI Meeting Assistant" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

<Card title="Call.md on GitHub" icon="github" href="https://github.com/video-db/call.md">
  Complete source code, installation guide, and configuration
</Card>

## What Is It?

Your AI meeting assistant, live during every call.

Most meeting tools transcribe after the fact. Call.md is different: it understands your meeting as it happens, giving you AI-powered suggestions, conversation metrics, and automatic tool triggers in real-time. It's like having an AI copilot who watches your meeting, tracks engagement, and whispers helpful context right when you need it.

After the call ends, it generates three-part summaries (overview, key points, action items) and can automatically update your CRM or project management tools through workflow webhooks.

If you've used Otter.ai or Fireflies.ai, think of Call.md as the same idea but built for agent automation—not just passive transcription, but active intelligence during and after meetings.

<Tip>
  **The Power**: During calls, AI generates contextual suggestions, monitors conversation balance, and automatically triggers your MCP tools when information needs arise — all in real-time.
</Tip>

## Why You Need This

<Tabs>
  <Tab title="Live Intelligence" icon="zap">
    ### During the Meeting

    Get real-time assistance while you talk:

    * AI-generated suggestions (things to say, questions to ask)
    * Conversation metrics (talk ratio, pace, questions asked)
    * MCP tools triggered automatically from conversation context
    * Coaching nudges when conversation needs steering
  </Tab>

  <Tab title="Meeting Intelligence" icon="brain">
    ### Post-Meeting Analysis

    Comprehensive summaries after every call:

    * Three-part AI summary (overview, key points, action items)
    * Full transcript with dual-channel separation
    * Conversation metrics and engagement statistics
    * Markdown export with complete meeting intelligence
  </Tab>

  <Tab title="Agent Integration" icon="bot">
    ### MCP Automation

    Connect your agent ecosystem:

    * Auto-triggers MCP tools during conversations
    * Results appear inline during meetings
    * Workflow webhooks to n8n, Zapier, CRMs
    * Agent-ready structured output
  </Tab>
</Tabs>

## How It Works

<Steps>
  <Step title="Dual-Channel Transcription">
    Captures your mic (labeled "you") and system audio (labeled "them") separately. This separation powers all downstream intelligence.
  </Step>
</Steps>

<Tip>
  **Why Dual-Channel Matters**: Separating "you" (microphone) from "them" (system audio) isn't just for attribution. It enables Call.md to track conversation balance, detect when one person is dominating, measure your speaking pace independently, and generate insights like "You asked 3 questions but the client asked 0—they might not be engaged." Single-channel transcription can't do this.
</Tip>

<Steps>
  <Step title="Live Assist">
    Every 20 seconds, AI analyzes recent transcript and generates contextual suggestions: things to say, questions to ask.
  </Step>

  <Step title="Conversation Metrics">
    Real-time tracking of talk ratio, speaking pace (WPM), questions asked, and monologue detection. No LLM required — pure statistics.
  </Step>

  <Step title="MCP Auto-Triggering">
    Intent detector scans conversation for information needs (active or passive). When detected, automatically calls relevant MCP tools and displays results inline.
  </Step>

  <Step title="Post-Meeting Intelligence">
    When the meeting ends, generates three parallel summaries: narrative overview, key points by topic, and action items. Sends to workflow automation platforms.
  </Step>
</Steps>

## Key Features

<AccordionGroup>
  <Accordion title="Recording & Transcription" icon="mic">
    **Real-Time Speech-to-Text**

    * Separate channels for you and them
    * Live transcription powered by VideoDB
    * Recording history with full transcripts
    * Screen, mic, and system audio capture
  </Accordion>

  <Accordion title="Live Assist" icon="lightbulb">
    **AI-Generated Suggestions**

    * Contextual things to say
    * Questions to ask
    * Updates every 20 seconds
    * Based on recent conversation context
  </Accordion>

  <Accordion title="Conversation Metrics" icon="chart-bar">
    **Track Engagement**

    * Talk ratio (you vs them)
    * Speaking pace and question count
    * Engagement score
    * Monologue detection (45s threshold)
  </Accordion>

  <Accordion title="MCP Integration" icon="plug">
    **Model Context Protocol**

    * Auto-triggers tools from conversation
    * Runs every 20 seconds
    * Max 3 tool calls per run
    * Results display inline during meetings
    * Supports stdio and HTTP servers
  </Accordion>

  <Accordion title="MCP Auto-Triggering Example" icon="lightbulb">
    **How it works in practice:**

    During a sales call, the client mentions "Can you send me pricing for the enterprise plan?" The MCP intent detector recognizes this as an information need, automatically calls your CRM tool to fetch the pricing doc, and displays it inline. You see the result immediately and can reference it without breaking flow.

    Or: A customer says "I'm seeing error code 502." The MCP agent searches your knowledge base tool, finds relevant docs, and shows them to you in real-time—before you even finish taking notes.

    This happens automatically every 20 seconds based on conversation context. You configure which MCP tools are available; the agent decides when to call them.
  </Accordion>

  <Accordion title="Post-Meeting Summaries" icon="file-text">
    **Three-Part AI Analysis**

    * Short overview (3-5 sentence narrative)
    * Key points by topic (attributed to participants)
    * Action items (3-10 concrete next steps)
    * Generated in parallel for speed
  </Accordion>

  <Accordion title="Workflow Webhooks" icon="webhook">
    **Automation Integration**

    * Auto-send to n8n, Zapier, CRMs
    * Triggered when meeting ends
    * Structured data payload
    * Agent-ready output format
  </Accordion>

  <Accordion title="Meeting Preparation" icon="clipboard-list">
    **Setup Wizard**

    * AI-generated probing questions
    * Dynamic discussion checklist
    * Google Calendar integration
    * Sync upcoming meetings
  </Accordion>

  <Accordion title="Bookmarking" icon="bookmark">
    **Mark Important Moments**

    * Quick bookmark during calls
    * Review later with context
    * Share with team
  </Accordion>
</AccordionGroup>

## Tech Stack

Built for performance and reliability:

<Columns cols={2}>
  <Card title="Electron 34" icon="app-window">
    Desktop application shell
  </Card>

  <Card title="React 19 + TypeScript 5.8" icon="code">
    Modern UI with full type safety
  </Card>

  <Card title="tRPC 11" icon="plug">
    Type-safe API layer
  </Card>

  <Card title="Drizzle + SQLite" icon="database">
    Local offline-first storage
  </Card>

  <Card title="VideoDB SDK (0.2.4)" icon="zap">
    Recording and transcription
  </Card>

  <Card title="MCP SDK (1.0.0)" icon="link">
    Model Context Protocol integration
  </Card>

  <Card title="OpenAI SDK (6.19.0)" icon="brain">
    LLM calls via VideoDB API
  </Card>

  <Card title="Tailwind + shadcn/ui" icon="palette">
    Beautiful, modern interface
  </Card>
</Columns>

## Getting Started

<Info>
  **Prerequisites**

  * macOS 12+ (Monterey or later) or Windows 10+
  * [VideoDB API key](https://console.videodb.io) (free tier available)
</Info>

<Steps>
  <Step title="Install Call.md">
    **macOS** (Apple Silicon & Intel):

    ```bash theme={null}
    curl -fsSL https://artifacts.videodb.io/call.md/install | bash
    ```

    *Currently available for macOS and Windows — Linux support coming soon*
  </Step>

  <Step title="Launch and Register">
    1. Launch Call.md from Applications or Spotlight
    2. Enter your VideoDB API key ([get one free](https://console.videodb.io))
    3. Grant system permissions when prompted
  </Step>

  <Step title="Configure Recording">
    Configure preferences:

    * Enable microphone capture
    * Enable system audio capture
    * Select screen to record
    * Optionally connect Google Calendar
  </Step>

  <Step title="Start Your First Meeting">
    1. Click "New Meeting" from home screen
    2. Optionally run Meeting Setup wizard
    3. Click "Start Recording"
    4. Watch live transcription and intelligence
  </Step>
</Steps>

<Warning>
  **macOS Permissions Required**

  Grant in **System Preferences > Privacy & Security**:

  * Microphone (for voice recording)
  * Screen Recording (for screen capture)
</Warning>

## Configuration

All features are configurable through Settings:

| Feature              | Customizable                               |
| -------------------- | ------------------------------------------ |
| Live Assist          | Enable/disable, configure timing           |
| Conversation Metrics | Set thresholds for talk ratio alerts       |
| MCP Servers          | Add stdio/HTTP servers, manage connections |
| Workflow Webhooks    | Configure n8n, Zapier, or custom endpoints |
| Google Calendar      | Connect/disconnect calendar sync           |

### MCP Server Setup

Connect MCP servers in **Settings → MCP Servers**:

1. Click **Add Server**
2. Choose transport: **stdio** (local) or **http** (remote)
3. Configure connection details
4. Click **Connect**

The MCP agent runs automatically during meetings, detects information needs from conversation, and triggers relevant tools. Results appear inline in the **MCP Results** panel.

## Privacy & Data

<Check>**Local Database** - All data stored in SQLite at `~/Library/Application Support/call-md/`</Check>
<Check>**Secure Storage** - API keys encrypted, credentials protected</Check>
<Check>**User Control** - Delete recordings anytime, export transcripts</Check>
<Check>**Transcription via VideoDB** - AI features require internet connectivity</Check>

***

<Card title="Complete Setup Guide on GitHub" icon="github" href="https://github.com/video-db/call.md">
  Detailed installation instructions, configuration options, and troubleshooting guide
</Card>

## Related Tutorials

<CardGroup cols={2}>
  <Card title="Bloom" icon="video" href="/examples-and-tutorials/ai-copilots/bloom">
    Screen recorder with AI search for async video documentation
  </Card>

  <Card title="Pair Programmer" icon="code" href="/examples-and-tutorials/ai-copilots/pair-programmer">
    AI coding assistant with real-time screen and audio context
  </Card>

  <Card title="Focusd" icon="chart-line" href="/examples-and-tutorials/ai-copilots/focusd">
    AI-powered productivity tracking with automatic time insights
  </Card>
</CardGroup>
