# Meeting Chief Lite

Minimal meeting transcript sync and search MCP. Downloads meetings from Otter.ai, stores them in SQLite, and provides semantic search via MCP tools.

## Features

- **Otter.ai Sync**: Download meeting transcripts automatically
- **Semantic Search**: Find relevant transcript chunks using embeddings
- **Keyword Search**: Fallback for exact text matching
- **MCP Tools**: 3 focused tools for Claude/Cursor integration

## Tools

| Tool | Description |
|------|-------------|
| `meetings` | List, get, and browse meeting transcripts |
| `search` | Semantic and keyword search across transcripts |
| `status` | System health, sync status, and management |

## Quick Start

### 1. Configure Environment

```bash
cp .env.example .env
# Edit .env with your credentials:
# - OTTER_EMAIL
# - OTTER_PASSWORD
# - OPENROUTER_API_KEY
```

### 2. Run with Docker

```bash
# Build and run
docker compose up -d

# Or run directly
docker run -it \
  -e OTTER_EMAIL=your@email.com \
  -e OTTER_PASSWORD=yourpassword \
  -e OPENROUTER_API_KEY=sk-or-v1-xxx \
  -v meeting-chief-data:/data \
  ghcr.io/smcdonnell7/meeting-chief-lite
```

### 3. Configure MCP Client

**Cursor (`~/.cursor/mcp.json`):**
```json
{
  "mcpServers": {
    "meeting-chief-lite": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "OTTER_EMAIL",
        "-e", "OTTER_PASSWORD", 
        "-e", "OPENROUTER_API_KEY",
        "-v", "meeting-chief-data:/data",
        "ghcr.io/smcdonnell7/meeting-chief-lite"
      ]
    }
  }
}
```

**Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):**
```json
{
  "mcpServers": {
    "meeting-chief-lite": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "OTTER_EMAIL=your@email.com",
        "-e", "OTTER_PASSWORD=yourpassword",
        "-e", "OPENROUTER_API_KEY=sk-or-v1-xxx",
        "-v", "meeting-chief-data:/data",
        "ghcr.io/smcdonnell7/meeting-chief-lite"
      ]
    }
  }
}
```

## Usage Examples

```
# List recent meetings
meetings operation:list limit:10

# Get specific meeting
meetings operation:get id:meeting_123

# Search transcripts
search query:"API migration" mode:semantic

# Search with date filter
search query:"budget" after:2026-01-01

# Check system status
status operation:health

# Sync from Otter.ai
status operation:run_sync sync_days:30

# Generate embeddings for new meetings
status operation:generate_embeddings
```

## Database

SQLite database with 7 tables:

- `meetings` - Meeting metadata and transcripts
- `transcript_chunks` - Parsed transcript segments
- `transcript_vectors` - Embeddings for semantic search
- `embedding_jobs` - Embedding generation queue
- `sync_runs` - Sync audit log
- `speakers` - People roster
- `app_settings` - Configuration

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start
```

## License

MIT