macos-say

Use macOS text-to-speech via the `say` command for voice feedback, audio narration, and spoken output.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026

When & Why to Use This Skill

The macOS-say skill integrates the native macOS text-to-speech (TTS) engine into Claude's workflow. It allows for real-time voice feedback, the generation of audio narrations, and the conversion of text files into spoken audio using the system's built-in 'say' command, significantly enhancing local automation and accessibility.

Use Cases

  • Task Completion Alerts: Set up spoken notifications to announce when long-running terminal commands, software builds, or data processing tasks are finished.
  • Audio Content Generation: Convert written scripts, articles, or documentation into high-quality audio files (AAC/m4a) for podcasts, presentations, or offline listening.
  • Accessibility Support: Provide an auditory interface for text-based outputs, assisting users with visual impairments or those who prefer multi-modal interaction.
  • Development Debugging: Use different system voices to provide audible status updates or error warnings during the execution of complex local scripts.
namemacos-say
descriptionUse macOS text-to-speech via the `say` command for voice feedback, audio narration, and spoken output.

macOS Say Command

Provide voice feedback using macOS's built-in say command.

Basic Usage

say "Hello, world"

Key Options

  • -v <voice> - Select voice (e.g., Samantha, Alex, Daniel)
  • -r <rate> - Words per minute (default ~175)
  • -o <file> - Output to audio file
  • -f <file> - Read text from file

Common Patterns

say "Task complete" & # Non-blocking notification say -v Daniel "Build finished" # Specific voice say -o out.m4a --data-format=aac "Save as audio"

List voices: say -v ?