Transcribe Voice Notes

Transcribe WhatsApp voice notes and correct mining-site mis-transcriptions.

1|Updated Jul 30, 2025
One-click install
npx skills add https://github.com/karstegg/MarthaVault --skill transcribe-voice-notes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Transcribe Voice Notes
Source: https://github.com/karstegg/MarthaVault/tree/main/.claude/skills/transcribe-voice-notes
Command: npx skills add https://github.com/karstegg/MarthaVault --skill transcribe-voice-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill downloads WhatsApp voice notes, transcribes them, and applies mining-site terminology corrections to produce clean, task-ready text.

Core Features & Use Cases

  • Automatic transcription of WhatsApp voice notes using the gpt-4o-mini-transcribe model
  • Built-in dictionary of mining-site mis-transcriptions with automatic corrections
  • Output ready for creating structured tasks and notes

Quick Start

Use the slash command /transcribe-voice-notes to process voice notes from a contact. Alternatively, run: python transcribe_voice_notes.py --contact "27833911315" --limit 5

Frequently Asked Questions about Transcribe Voice Notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transcribe WhatsApp voice notes automatically?▼

Transcribe WhatsApp voice notes by using the gpt-4o-mini-transcribe model to convert audio to text. The Skill downloads voice notes from a contact, processes them through the transcription model, and outputs text ready for task creation or documentation.

Can I correct mining-site terminology in transcriptions automatically?▼

Yes. The Skill applies a built-in corrections dictionary to fix common mining-site mis-transcriptions after transcription. This ensures output uses correct terminology without manual editing.

What do I need to set up before transcribing voice notes?▼

You need a WhatsApp MCP server for voice-note access, the gpt-4o-mini-transcribe model available, and a designated media/audio vault directory. The Skill downloads and copies audio files to this vault before processing.

How do I process multiple voice notes from a contact at once?▼

Run the slash command /transcribe-voice-notes with a contact identifier, or execute the Python script with the --contact parameter and --limit flag. For example: --contact "27833911315" --limit 5 processes up to five notes from that contact.

What output format does the Skill produce after transcription?▼

The Skill outputs corrected transcriptions paired with metadata formatted for downstream task creation. Text is cleaned of mining-site terminology errors and structured for integration into task management or documentation systems.

Does this work with contacts outside my organization?▼

The Skill processes voice notes from any WhatsApp contact accessible through your MCP server. Functionality depends on WhatsApp server configuration and contact permissions, not organizational boundaries.