- name
- readai
- description
- >
Read AI Integration
Pull meeting intelligence from Read AI via REST API or webhook receiver.
Auth
Two data sources supported:
- Limitless Pendant (primary) - Captures all conversations including meetings via API
- 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).
# One-time setup
mkdir -p ~/.config/readai
echo "YOUR_API_KEY" > ~/.config/readai/api-key
chmod 600 ~/.config/readai/api-keyFor 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
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 outputGet Meeting Details
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 onlySearch Meetings
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
python3 scripts/readai_client.py export <meeting_id> # Markdown
python3 scripts/readai_client.py export <meeting_id> --format jsonWebhook Setup
For real-time meeting data, set up the webhook receiver:
- Run:
python3 scripts/webhook_receiver.py --port 9010 - In Read AI Dashboard > Settings > Integrations > Webhooks
- 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/:
~/.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 searchLimitless Lifelog Pull
# 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