Skip to main content
Glama

MCP Play Sound Server

by davidteren
GitHub
Python
MIT License
1
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Play Sound Server

A Model Context Protocol (MCP) server that provides audio playback functionality for AI agents. This server enables AI agents to play sound notifications when coding tasks are completed.

⚠️ Early Version / Proof of Concept This is an early implementation currently tested only on macOS. Future versions will support additional platforms.

Features

  • Audio Notifications: Play sound alerts when AI tasks complete
  • Default Sound: Bundled notification sound for immediate use
  • Custom Audio: Support for custom audio files (WAV, MP3, FLAC, OGG, M4A)
  • Intelligent Fallback: Automatic fallback to default sound if custom audio fails
  • macOS Support: Currently tested on macOS using AFPlay and SimpleAudio

Installation & Setup

Development Setup

  1. Clone and install:
git clone <repository-url> cd play-sound-mcp-server python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -e ".[dev]"
  1. Configure Claude Desktop: Add to your claude_desktop_config.json:
{ "mcpServers": { "play-sound": { "command": "uv", "args": [ "--directory", "/path/to/your/play-sound-mcp-server", "run", "mcp-server-play-sound" ] } } }
  1. Test: Restart Claude Desktop and ask: "Can you play a notification sound?"

Configuration

Environment variables (optional):

  • CUSTOM_SOUND_PATH: Path to custom audio file
  • VOLUME_LEVEL: Playback volume (0.0-1.0, default: 0.8)
  • ENABLE_FALLBACK: Enable fallback to default sound (default: true)
  • AUDIO_DEVICE: Specific audio output device name (e.g., "Mac Studio Speakers")

Available Tools

play_notification_sound

Plays a notification sound to alert the user.

Parameters:

  • custom_sound_path (optional): Path to custom audio file
  • message (optional): Context message for the notification

get_audio_status

Returns current audio system status and configuration.

test_audio_playback

Tests audio playback functionality.

Parameters:

  • use_custom (optional): Test with custom sound if configured

list_audio_devices

Lists all available audio output devices on the system.

Returns:

  • List of available audio devices with their properties
  • Current configured device (if any)
  • Default device information

Development

Prerequisites

  • Python 3.10+
  • uv (recommended) or pip

Testing

pytest tests/

License

MIT License - see the LICENSE file for details.

Acknowledgments

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Provides audio playback functionality for AI agents, allowing them to play notification sounds when coding tasks are completed.

  1. Features
    1. Installation & Setup
      1. Development Setup
    2. Configuration
      1. Available Tools
        1. play_notification_sound
        2. get_audio_status
        3. test_audio_playback
        4. list_audio_devices
      2. Development
        1. Prerequisites
        2. Testing
      3. License
        1. Acknowledgments

          Related MCP Servers

          • Cursor Sound MCP

            ericlistin
            -
            security
            F
            license
            -
            quality
            Provides audio feedback by playing sound effects when Cursor AI completes code generation, creating a more interactive coding experience.
            Last updated -
            15
            TypeScript

          • MCP Notify Server

            Cactusinhand
            -
            security
            A
            license
            -
            quality
            A Model Context Protocol service that sends desktop notifications and alert sounds when AI agent tasks are completed, integrating with various LLM clients like Claude Desktop and Cursor.
            Last updated -
            13
            Python
            MIT License
            • Apple
            • Linux

          • Audio MCP Server

            GongRzhe
            -
            security
            A
            license
            -
            quality
            Enables Claude and other AI assistants to interact with your computer's audio system, allowing for recording from microphones and playing audio through speakers.
            Last updated -
            2
            Python
            MIT License
            • Linux
            • Apple

          • Cursor Sound MCP

            bcharleson
            -
            security
            F
            license
            -
            quality
            Plays sound effects when Cursor AI completes code generation, providing audio feedback for a more interactive coding experience.
            Last updated -
            TypeScript

          View all related MCP servers

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/davidteren/play-sound-mcp-server'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server