MMK Plaud
Prerequisite: Read ../mmk-shared/SKILL.md for auth, global flags, and error handling.
Read-only access to the unofficial Plaud web API using the mmk CLI. Covers recording listing, transcript and summary retrieval, folder organization, transcript search, and admin diagnostics.
Always use -o json when parsing results or composing with other commands.
Sub-Command Skills
| Sub-command |
Description |
Skill |
file |
List/inspect recordings, get audio URL, download, rename, organize into folders, fetch transcripts/summaries, list/get content tabs, trigger auto transcript+summary, trash notes (12 commands) |
mmk-plaud-file |
search |
Search transcripts and filenames (1 command) |
mmk-plaud-search |
user |
Show current Plaud user profile (1 command) |
mmk-plaud-user |
doctor |
Connectivity check: validates token and lists user/devices (1 command) |
mmk-plaud-doctor |
admin |
Advanced 1:1 API passthroughs: AI status, combine tasks, config, devices, file ack/share, membership, search history, tags, trans-quota, feature access (13 commands) |
mmk-plaud-admin |
Requirements
- Pro license required on the MMK server (plaud commands check this on every call).
- A valid Plaud bearer token is loaded by default from Google Cloud Secret Manager on the server side.
Plaud Credential Overrides
All mmk plaud … commands accept two shared flags for ad-hoc overrides or testing:
| Flag |
Env var |
Purpose |
--plaud-token |
MMK_PLAUD_TOKEN |
Override Plaud bearer token (format: bearer eyJ...) |
--plaud-api-domain |
MMK_PLAUD_API_DOMAIN |
Override Plaud regional API domain (e.g. https://api-apne1.plaud.ai) |
When omitted, the server falls back to its configured secret.
High-level vs Low-level
Prefer the user-facing verbs under mmk plaud file … and mmk plaud search. The mmk plaud admin … subtree is a 1:1 passthrough to upstream Plaud endpoints — use it only for power-user scripting, troubleshooting, or features not yet exposed by the higher-level commands.
For folder assignment, prefer mmk plaud file organize (which finds-or-creates the tag and assigns files in one call) over the lower-level mmk plaud admin tag … primitives.
Tips
mmk plaud doctor is the fastest way to verify token + connectivity before scripting.mmk plaud file list --with transcripts,summaries composes attachments in one call — use --concurrency (1–8) to tune parallelism and --strict to fail-fast on any attachment error.mmk plaud file transsumm --wait polls the server until the transcript+summary task completes, returning both artifacts together.- Always use
-o json for reliable parsing in scripts and skill compositions.
1---2name: mmk-plaud3description: This skill should be used when the user asks to list Plaud recordings, fetch transcripts/summaries, organize recordings into folders, search transcripts, inspect Plaud devices, check membership/quota, or any Plaud voice recorder operation using the mmk CLI. Triggers on phrases like "plaud", "plaud recordings", "plaud transcript", "plaud summary", "plaud search", "plaud folder", "organize recordings", "plaud doctor", "plaud quota", "plaud membership", "plaud devices".4---56# MMK Plaud78> **Prerequisite:** Read [`../mmk-shared/SKILL.md`](../mmk-shared/SKILL.md) for auth, global flags, and error handling.910Read-only access to the unofficial Plaud web API using the `mmk` CLI. Covers recording listing, transcript and summary retrieval, folder organization, transcript search, and admin diagnostics.1112Always use `-o json` when parsing results or composing with other commands.1314## Sub-Command Skills1516| Sub-command | Description | Skill |17|-------------|-------------|-------|18| `file` | List/inspect recordings, get audio URL, download, rename, organize into folders, fetch transcripts/summaries, list/get content tabs, trigger auto transcript+summary, trash notes (12 commands) | [`mmk-plaud-file`](../mmk-plaud-file/SKILL.md) |19| `search` | Search transcripts and filenames (1 command) | [`mmk-plaud-search`](../mmk-plaud-search/SKILL.md) |20| `user` | Show current Plaud user profile (1 command) | [`mmk-plaud-user`](../mmk-plaud-user/SKILL.md) |21| `doctor` | Connectivity check: validates token and lists user/devices (1 command) | [`mmk-plaud-doctor`](../mmk-plaud-doctor/SKILL.md) |22| `admin` | Advanced 1:1 API passthroughs: AI status, combine tasks, config, devices, file ack/share, membership, search history, tags, trans-quota, feature access (13 commands) | [`mmk-plaud-admin`](../mmk-plaud-admin/SKILL.md) |2324## Requirements2526- **Pro license** required on the MMK server (plaud commands check this on every call).27- A valid Plaud bearer token is loaded by default from Google Cloud Secret Manager on the server side.2829## Plaud Credential Overrides3031All `mmk plaud …` commands accept two shared flags for ad-hoc overrides or testing:3233| Flag | Env var | Purpose |34|------|---------|---------|35| `--plaud-token` | `MMK_PLAUD_TOKEN` | Override Plaud bearer token (format: `bearer eyJ...`) |36| `--plaud-api-domain` | `MMK_PLAUD_API_DOMAIN` | Override Plaud regional API domain (e.g. `https://api-apne1.plaud.ai`) |3738When omitted, the server falls back to its configured secret.3940## High-level vs Low-level4142Prefer the user-facing verbs under `mmk plaud file …` and `mmk plaud search`. The `mmk plaud admin …` subtree is a 1:1 passthrough to upstream Plaud endpoints — use it only for power-user scripting, troubleshooting, or features not yet exposed by the higher-level commands.4344For folder assignment, prefer `mmk plaud file organize` (which finds-or-creates the tag and assigns files in one call) over the lower-level `mmk plaud admin tag …` primitives.4546## Tips47481. `mmk plaud doctor` is the fastest way to verify token + connectivity before scripting.492. `mmk plaud file list --with transcripts,summaries` composes attachments in one call — use `--concurrency` (1–8) to tune parallelism and `--strict` to fail-fast on any attachment error.503. `mmk plaud file transsumm --wait` polls the server until the transcript+summary task completes, returning both artifacts together.514. Always use `-o json` for reliable parsing in scripts and skill compositions.
magic-meal-kits