OpenParable
Skip to content
← Back to skills

Voicenotes

Apps & Automation
voicenotes

Voicenotes is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/voicenotes/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/voicenotes, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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