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.