Percept Meetings
Give your OpenClaw agent context from meetings captured by Zoom, Granola, or Omi wearables. Search transcripts, extract action items, identify speakers, and act on meeting outcomes. Use when the user asks about meetings, what was discussed, action items, follow-ups, who said what, meeting summaries, or when the agent needs meeting context to complete a task. Also triggers for: what did we talk about, meeting notes, transcript, action items, follow up on, schedule based on our meeting, what did [person] say.
Percept Meetings
Give your OpenClaw agent ears. This skill connects meeting data from Zoom, Granola, and Omi wearables into your agent's context — searchable transcripts, speaker identification, entity extraction, and actionable follow-ups.
Quick Start
1. Install Percept
pip install getpercept # or: git clone https://github.com/GetPercept/percept
cd percept && pip install -e .
2. Connect a Source
Granola (zero config — reads local cache):
percept granola-sync
Zoom (needs OAuth app):
export ZOOM_ACCOUNT_ID=xxx ZOOM_CLIENT_ID=xxx ZOOM_CLIENT_SECRET=xxx
percept zoom-sync --days 7
Omi wearable (real-time):
percept serve --port 8900
# Configure Omi webhook → https://your-host:8900/webhook/transcript?token=YOUR_TOKEN
3. Use Meeting Context
Search what was discussed:
percept search "budget approval"
List recent transcripts:
percept transcripts --today
Check who was in meetings:
percept speakers
Get action items from latest meeting:
percept actions
How to Use in Agent Workflows
Finding Meeting Context
When the user asks about meetings or you need context from a past conversation:
# Search by topic
percept search "VectorCare API migration"
# Search by person
percept search "what did Sarah say"
# Recent meetings
percept transcripts --limit 5
Output is JSON — parse it for structured data.
Acting on Meetings
When meetings produce action items or follow-ups:
- Search for the relevant meeting:
percept search "<topic>" - Extract action items from the transcript
- Use other OpenClaw tools to execute (send emails, create tasks, schedule follow-ups)
Example flow: User says "follow up on what we discussed with the sales team"
→ percept search "sales team" → find action items → draft follow-up email
Importing New Data
Granola auto-discovers meetings from ~/Library/Application Support/Granola/cache-v3.json.
Run percept granola-sync to pull latest. Supports --since YYYY-MM-DD for date filtering.
Zoom requires a Server-to-Server OAuth app from marketplace.zoom.us:
- Scopes needed:
recording:read,user:read - Run
percept zoom-syncto batch-import, or start webhook server for auto-import - See references/zoom-setup.md for detailed setup
Omi streams in real-time via webhook. See references/omi-setup.md.
Configuration
Percept stores data in percept/data/percept.db (SQLite with FTS5 full-text search).
Key env vars:
PERCEPT_DB_PATH— custom database locationPERCEPT_API_TOKEN— bearer token for API endpointsZOOM_ACCOUNT_ID,ZOOM_CLIENT_ID,ZOOM_CLIENT_SECRET— Zoom OAuthGRANOLA_API_KEY— Granola Enterprise API (optional; local cache works without it)
Pipeline Health
percept status
Returns: server status, live stream status, today's conversation count, database stats.
Related skills
- Downloads
- 696All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
