Voicenotes Integration
Sync voice notes from voicenotes.com into the workspace.
Setup
- Get access token from: https://voicenotes.com/app?obsidian=true#settings
- Set environment variable:
export VOICENOTES_TOKEN="your-token-here"
Quick Start
# Verify connection
./scripts/get-user.sh | jq .
Fetch recent notes (JSON)
./scripts/fetch-notes.sh | jq '.data[:3]'
Sync all notes to markdown files
./scripts/sync-to-markdown.sh --output-dir ./voicenotes
Scripts
fetch-notes.sh
Fetch voice notes as JSON.
./scripts/fetch-notes.sh # All notes
./scripts/fetch-notes.sh --limit 10 # Last 10 notes
./scripts/fetch-notes.sh --since 2024-01-01 # Notes since date
get-user.sh
Verify token and get user info.
./scripts/get-user.sh | jq '{name, email}'
sync-to-markdown.sh
Sync notes to markdown files with frontmatter.
./scripts/sync-to-markdown.sh --output-dir ./voicenotes
Output format:
---
voicenotes_id: abc123
created: 2024-01-15T10:30:00Z
tags: [idea, project]
---
Note Title
Transcript
The transcribed content...
Summary
AI-generated summary...
API Reference
Base URL:
https://api.voicenotes.com/api/integrations/obsidian-sync
Headers required:
Authorization: Bearer {token}
X-API-KEY: {token}
Endpoints:
GET /user/info
- User detailsGET /recordings
- List voice notes (paginated)GET /recordings/{id}/signed-url
- Audio download URL
Data Structure
Each voice note contains:
recording_id
- Unique identifiertitle
- Note titletranscript
- Full transcript textcreations[]
- AI summaries, action items, etc.tags[]
- User tagscreated_at
/ updated_at
- Timestampsduration
- Recording length in seconds
Tips
- Notes are paginated; check
links.next
for more pages
- Use
--since
to fetch only new notes since last sync
- AI creations include summaries, todos, and custom prompts
- Rate limited to ~60 requests/minute
