Connect Wispr Flow
Wispr Flow records meetings and writes a summary. This connects it to Dex so
those captures arrive in 00-Inbox/Meetings/ by themselves, and /process-meetings
treats them exactly like any other meeting note.
What makes this connection different, and why it matters to you
Dex holds the credential itself rather than borrowing one from whichever app you happen to be running. That is the difference between a source that works while you are sitting in a session and one that works overnight. Once connected:
- Captures can be fetched on a schedule, so they are in the vault before you open Dex in the morning.
- The connection follows the vault. It works the same in Claude Code, Cursor, or anything else that runs Dex, because nothing depends on that app's own connector store.
Before you start
You need a Wispr Flow account with the notetaker enabled. There is no key to paste and nothing to copy: you authorise once in a browser.
Step 1: Run the connection
python3 -c "from pathlib import Path; from core.meeting_sources.wispr_setup import connect; print(connect(Path('.')))"
This registers Dex with Wispr, opens your browser, and waits for you to approve.
When you do, it stores the credential in System/.dex/wispr-credential.json
with owner-only permissions.
If the browser does not open, the command prints the URL. Open it yourself.
Step 2: Confirm it worked
python3 -c "from pathlib import Path; from core.meeting_sources import wispr_client; print(wispr_client.list_tools(Path('.')))"
You should see the tools Wispr exposes. If this fails, say what the error was rather than assuming the connection is fine.
Step 3: Pull your recent captures
python3 -m core.meeting_sources.wispr_sync
It reports what it did in one line. Then run /process-meetings to turn the new
notes into person page updates and tasks.
Step 4: Keep it running (optional)
To have captures arrive on their own, schedule the same command. On macOS that
is a launch agent running python3 -m core.meeting_sources.wispr_sync with
VAULT_PATH set to your vault.
Two things to tell the user plainly
Your captures may arrive without attendee names. Wispr titles and attributes a capture from the calendar it is connected to, and its calendar sync is Google only. On Microsoft 365 the capture arrives with no title and no attendees, so Dex derives a title from the summary and marks the note as unresolved. Speaker labels in the summary are turns in a recording, not people. Do not let anything downstream assign an action or a quote on the strength of that note alone; match it against the calendar entry for that time first.
The credential is in your vault. System/.dex/wispr-credential.json holds a
refresh token. If your backups include System/, exclude that file, in the same
way .env is excluded. Anyone who can read it can read your meetings.
If it stops working
Wispr's access tokens last five minutes and the refresh token is replaced every time it is used, so the stored file is rewritten constantly. If the credential is lost or corrupted, re-run Step 1: there is nothing to recover and re-authorising takes one browser click.
Say plainly when the connection is broken. A meeting source that quietly returns nothing looks exactly like a quiet week, and that is the failure this setup is built to avoid.
