Read AI Integration#

Pull meeting intelligence from Read AI via REST API or webhook receiver.

Auth#

Two data sources supported:

1. Limitless Pendant (primary) - Captures all conversations including meetings via API
2. Read AI Webhook - Real-time meeting summaries pushed from Read AI

API key stored at ~/.config/readai/api-key (same as Limitless key if using pendant).

bash

# One-time setup
mkdir -p ~/.config/readai
echo "YOUR_API_KEY" > ~/.config/readai/api-key
chmod 600 ~/.config/readai/api-key

For Limitless: Get key from limitless.ai dashboard. For Read AI API: Get key from Read AI Dashboard > Settings > Integrations > API Keys.

Quick Commands#

List Recent Meetings#

bash

python3 scripts/list_meetings.py              # Last 7 days
python3 scripts/list_meetings.py --days 30    # Last 30 days
python3 scripts/list_meetings.py --today      # Today only
python3 scripts/list_meetings.py --json       # JSON output

Get Meeting Details#

bash

python3 scripts/readai_client.py get <meeting_id>
python3 scripts/readai_client.py get <meeting_id> --transcript   # Full transcript
python3 scripts/readai_client.py get <meeting_id> --actions      # Action items only

Search Meetings#

bash

python3 scripts/search_meetings.py "quarterly review"
python3 scripts/search_meetings.py "budget" --days 30
python3 scripts/search_meetings.py "action items" --speaker "Brandon"

Export Meeting Summary#

bash

python3 scripts/readai_client.py export <meeting_id>             # Markdown
python3 scripts/readai_client.py export <meeting_id> --format json

Webhook Setup#

For real-time meeting data, set up the webhook receiver:

1. Run: python3 scripts/webhook_receiver.py --port 9010
2. In Read AI Dashboard > Settings > Integrations > Webhooks
3. Add URL: http://<your-server>:9010/webhook/readai

Webhook data is stored in ~/.readai/meetings/YYYY-MM-DD/.

See references/api-reference.md for full API documentation.

Data Structure#

Meetings include:

• Summary - AI-generated meeting recap
• Transcript - Full speaker-attributed transcript
• Action Items - Tasks with assignees
• Topics - Key discussion topics
• Participants - Attendees with engagement metrics
• Decisions - Key decisions made
• Duration/Timing - Start, end, duration

Local Data#

Data is stored/symlinked at ~/.readai/:

text

~/.readai/
├── meetings/                # Webhook-received meetings
│   └── YYYY-MM-DD/
│       ├── <timestamp>_<title>.json
│       └── <timestamp>_<title>.md
├── lifelogs/                # Limitless pendant data (symlink)
│   └── YYYY-MM-DD/
│       ├── raw_lifelogs.json
│       ├── entries.json
│       └── digest.md
└── index.json               # Meeting index for search

Limitless Lifelog Pull#

bash

# Pull today's pendant data (includes meetings)
python3 scripts/limitless_pull.py --today

# Pull specific date
python3 scripts/limitless_pull.py 2026-02-19

# Pull with AI summary
python3 scripts/limitless_pull.py --today --ai