Voicenotes Integration

Sync voice notes from voicenotes.com into the workspace.

Setup

1. Get access token from: https://voicenotes.com/app?obsidian=true#settings
2. 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 details
• GET /recordings - List voice notes (paginated)
• GET /recordings/{id}/signed-url - Audio download URL

Data Structure

Each voice note contains:

• recording_id - Unique identifier
• title - Note title
• transcript - Full transcript text
• creations[] - AI summaries, action items, etc.
• tags[] - User tags
• created_at / updated_at - Timestamps
• duration - 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