Plaud Importer

⚠️ Early Alpha

This plugin is in early alpha and under active development. Expect bugs, UI changes between releases, and occasional rough edges. It talks to an undocumented, reverse-engineered Plaud web API that Plaud can change at any time.

Before installing, please read What to know before you install. It explains the main tradeoffs in plain language, and exactly what the plugin will and will not touch in your vault.

No warranty. Use at your own risk, and you may want to test in a non-critical vault first.

Please report issues

I use this plugin myself every day, so I often catch breakage quickly, but I am one person on one account, and Plaud can change their API for some accounts or regions before it affects mine. If something breaks for you, an issue report is the single biggest help, and may be the first signal I get.

1. File a GitHub issue at ckelsoe/obsidian-plaud-importer/issues.
2. Include your Obsidian version, plugin version, OS, and steps to reproduce.
3. Attach a debug log. See Capturing a debug log below. Auth headers are redacted automatically.
4. Attach a screenshot or the generated note if the output looks wrong.

Feature requests and API-shape observations are welcome too. Open an issue or discussion.

Import meeting recordings, AI summaries, transcripts, and attachments from Plaud.AI into your Obsidian vault as markdown notes.

Each recording becomes a single note with frontmatter metadata, a Plaud-generated summary, and the transcript with chapter navigation. You choose whether the transcript sits under a heading, in a collapsed callout, or in its own file. Images, mind-maps, and other Plaud artifacts land in a matching -assets folder next to the note.

What to know before you install

Plaud does not offer an official API yet, so this plugin works by using Plaud's own (undocumented) web service the same way the Plaud website does. That is what makes it possible at all, and it brings a few tradeoffs worth understanding up front. None of them put your existing notes at risk.

The tradeoffs

• It can break when Plaud changes their website or API. There is no official, supported API, so Plaud can change how their service works at any time and an import may suddenly stop working. Why it works this way: it is the only way to get your recordings into Obsidian today. What protects you: the plugin shows a clear error instead of writing broken notes, and when Plaud ships an official API the plugin will move to it.
• Your sign-in token is like a key to your whole Plaud account. The plugin stores the session token your login uses. It is not a limited, read-only key. Why: that is the only credential Plaud's web service provides. What protects you: it is kept in Obsidian's secure secret storage, never written to your settings file, never logged, and never sent anywhere except Plaud.
• You sign in through Plaud's own website. Clicking Sign in opens Plaud's real site in a separate window so you can log in normally; Google and Apple logins use your normal browser instead (see Connect your Plaud account). Why: you never hand your password to the plugin. What protects you: the plugin reads only the token your logged-in session already uses; your password is typed into Plaud's own page, not the plugin.
• It is an unofficial tool, not affiliated with Plaud. What protects you: it reads only your own data, and only when you ask it to. Following Plaud's terms of service is your responsibility.
• Desktop only. Sign-in and import rely on desktop features that Obsidian Mobile does not provide.

What it will not do

• It only adds notes and attachments inside the output folder you choose, and never edits or deletes anything outside that folder. (To spot already-imported recordings it does read the frontmatter of notes inside your output folder. See Permissions and access.)
• It replaces an already-imported note only when you choose Overwrite (or confirm it under "Ask each time").
• It does not rewrite Plaud's transcript or summary text. It renders Plaud's own data into a note.
• The only change it can make in your Plaud account is a recording's title, and only if you turn on the optional title write-back and either confirm the prompt or opt into automatic updates (see Renaming recordings). It never edits or deletes anything else in Plaud. With that setting off, the plugin is read-only against Plaud.

This is the beginning of the README. Read the rest at the original. Read the full README ↗