Connect Wave to Obsidian
Every recording lands in your Obsidian vault as a Markdown note with the summary, action items and a folded transcript, and your Wave folders become vault folders.
The Wave AI plugin for Obsidian puts your recordings in your vault as plain Markdown files: the title, date, folder and tags as properties, the summary and action items as the note, and the original transcript folded up underneath. Markdown is plain text on your own device, so the notes are yours to edit, link and search, with or without Wave.
It works in Obsidian on Mac, Windows, Linux, iPhone, iPad and Android. The plugin is free, and syncing uses the same Wave account you record with.
Set it up
In Obsidian, open Settings → Community plugins, select Browse, search for Wave AI and select Install, then Enable.
Open the plugin's settings (Settings → Wave AI) and select Connect Wave. Your browser opens app.wave.co; sign in if you're asked to.
Check that the email shown is the account you record with, then select Connect Obsidian. Obsidian comes back to the front, and your recordings start appearing in a folder called Wave.
That's it. A large library syncs in the background; the status bar at the bottom of Obsidian shows progress, and you can keep working while it runs.
Prefer not to use the browser flow, or using Obsidian somewhere the browser can't hand off? Create a token at app.wave.co → Settings → Developers with the sessions, transcripts and folders read scopes, and paste it under Or paste an API token in the plugin's settings.
What each note looks like
Each recording becomes one file named after its title, for example Q4 Roadmap Review.md. Two recordings with the same title get the date added, as in Weekly Standup (2026-10-13).md.
The properties at the top:
title: "Q4 Roadmap Review"
date: 2026-10-13T10:30:12
duration_minutes: 34
type: "meeting"
platform: "google_meet"
folder: "Product"
tags:
- "roadmap"
wave_id: "sess_…"
wave_url: "https://app.wave.co/sessions/sess_…"Then the note itself:
## Q4 Roadmap Review
Three Q4 bets: offline mode, the sharing redesign, and the admin audit log…
## Action items
- [ ] Send legal the draft spec (JR) 📅 2026-10-20
> [!quote]- Transcript
> **Alex** · 0:59
> Q4 roadmap. We have room for three bets, not five…- Properties at the top: title, date and time, length in minutes, type, platform, language, the Wave folder, your tags, and a link back to the recording in Wave. Phone calls also carry the number and direction.
- The summary Wave wrote, as Markdown.
- Action items as a checklist. Assignees sit in brackets and due dates use the
📅form the Tasks plugin understands. - Your notes, if you typed any on the recording.
- The transcript, folded under the note, speaker by speaker with timestamps. Select the heading to expand it.
Recordings you've put in a Wave folder land in a subfolder with the same name, so a call filed under Customer Calls in Wave is at Wave/Customer Calls/ in your vault. A recording that's in several Wave folders goes in the pinned one, or the first by your folder order.
How syncing works
- It keeps itself up to date. The plugin checks for new recordings every 5 minutes while Obsidian is open, and whenever you come back to it. Select the Wave icon in the left ribbon, or run Wave AI: Sync now from the command palette, to check right away.
- Your edits win. Once a note is in your vault, it's yours. Edit it, move it, rename it or delete it, and Wave leaves it alone: a note you've changed is never written over, and a note you've deleted is never recreated. Notes you haven't touched pick up changes you make in Wave, such as a new title or a regenerated summary.
- It only goes one way. The plugin reads your Wave recordings. Nothing in your vault is sent back to Wave.
- Recordings deleted in Wave leave their note in place. Under When a recording is deleted in Wave, you can choose Move the note to trash instead; a note you've edited still stays.
To open the recording behind a note, run Wave AI: Open current note in Wave.
Settings
Open Settings → Wave AI to change where notes go and what they contain.
| Setting | What it does |
|---|---|
| Folder | The vault folder that holds your Wave notes. Wave by default. |
| Mirror Wave folders | Put recordings in subfolders named after your Wave folders. On by default. |
| File names | The title (default), or 2026-10-28 Title. |
| Transcript | Included and folded (default), included and expanded, or left out. |
| Action items and Your notes | Include them in each note. |
| Recordings to sync | Everything (default), or only the last 30, 90 or 365 days. New recordings always sync. |
| Check for new recordings every | 1, 5, 15 or 60 minutes. |
| Sync when Obsidian opens | On by default. |
| When a recording is deleted in Wave | Keep the note (default), or move it to trash. |
Changed what notes should contain? Select Rebuild notes (or run Wave AI: Rebuild notes from Wave) to apply the new options to notes you haven't edited.
Privacy and access
The plugin talks only to Wave's API, using a read-only token for your sessions, transcripts and folders. It sends nothing to anyone else. You can see the token and revoke it any time at app.wave.co → Settings → Developers; select Disconnect in the plugin's settings to sign out on that device.
FAQ
Yes. Install the plugin in Obsidian on iPhone, iPad or Android the same way, and connect it with the same Connect Wave button. Each device keeps its own connection.
No. If a note for a recording already exists in the vault (every synced note carries a wave_id property), the plugin uses it instead of writing another one.
You can choose whether the transcript, action items and notes are included, and how files are named. Beyond that, edit the note; the plugin won't touch a note you've changed.
Press Open Obsidian on the app.wave.co page. If that doesn't work either, paste a token instead, as described above.
Was this article helpful?
Still need help?