Voicenotes

SKILL.md

---
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](https://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

```bash
# 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.
```bash
./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.
```bash
./scripts/get-user.sh | jq '{name, email}'
```

### sync-to-markdown.sh
Sync notes to markdown files with frontmatter.
```bash
./scripts/sync-to-markdown.sh --output-dir ./voicenotes
```

Output format:
```markdown
---
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