| name | otter-fetch |
| description | Fetch Otter.ai transcript data. Sub-skill used by cache-notes and fill-participants when Notes: contains an Otter URL. |
| license | MIT |
Otter Fetch
Single place for obtaining Otter.ai transcript data. No direct slash command — other skills invoke this when they encounter an Otter.ai URL (e.g. in Notes: frontmatter).
Usage
This skill has no slash command. It's a sub-skill: /cache-notes and /fill-participants invoke its workflow (and run parse_otter.js) when a meeting's Notes: contains an https://otter.ai/u/... URL.
When to use
- cache-notes: When caching a meeting that has
https://otter.ai/u/{otid} in Notes: — need callout markdown to embed.
- fill-participants: When resolving participants for a meeting that only has Otter links (no Google Doc) — need speaker names from the transcript.
How to get the data
Otter has no public API. Use user-pasted JSON:
- Extract
otid from the URL: https://otter.ai/u/aBcDeFgHiJkLmNoPqRsT → otid = aBcDeFgHiJkLmNoPqRsT.
- Ask the user to copy the JSON response from
GET https://otter.ai/forward/api/v1/speech?otid={otid} (e.g. from DevTools → Network while signed in, or from a signed-in request).
- User pastes the JSON; the agent (or script) parses it.
Outputs (same JSON, different consumers)
The pasted JSON has speech with:
| Use case | What to use | How |
|---|
| cache-notes | Callout markdown | Run parse_otter.js with JSON on stdin → stdout is ## 🤖 AI Notes / ### Otter block with [!otter_notes]-, [!otter_todos]-, [!otter_transcript]-. |
| fill-participants | Speaker names | From speech.speakers: array of { speaker_name }. Use those names with people-resolver to build Participants:. |
So one paste can serve both skills if needed (e.g. cache-notes runs the script; fill-participants reads speech.speakers from the same JSON or from the cached transcript callout).
Script: parse_otter.js
In this folder: parse_otter.js reads the full Otter speech JSON from stdin and writes callout markdown to stdout (for cache-notes).
node .agents/skills/otter-fetch/parse_otter.js < pasted.json
Output is the exact block to append under ## 🤖 AI Notes (including ### Otter and the three callouts). Caller appends it to the note and sets NotesCached:.
Important notes
- Always extract
otid from the share URL (query params like ?utm_source=copy_url can be ignored).
- If the user doesn't have the JSON, they can open the Otter meeting page while signed in, open DevTools → Network, reload, and copy the response body of the
speech?otid=... request.
