π¦ ClawHub
Voicenotes
by @shawnhansen
Sync and access voice notes from Voicenotes.com. Use when the user wants to retrieve their voice recordings, transcripts, and AI summaries from Voicenotes. Supports fetching notes, syncing to markdown, and searching transcripts.
TERMINAL
clawhub install voicenotesπ About This Skill
name: voicenotes description: Sync and access voice notes from Voicenotes.com. Use when the user wants to retrieve their voice recordings, transcripts, and AI summaries from Voicenotes. Supports fetching notes, syncing to markdown, and searching transcripts.
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 detailsGET /recordings - List voice notes (paginated)GET /recordings/{id}/signed-url - Audio download URLData 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 secondsTips
links.next for more pages--since to fetch only new notes since last syncπ‘ Examples
# 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
βοΈ Configuration
1. Get access token from: https://voicenotes.com/app?obsidian=true#settings
2. Set environment variable: export VOICENOTES_TOKEN="your-token-here"
π Tips & Best Practices
links.next for more pages--since to fetch only new notes since last sync