MCP Play Sound Server

@davidteren

Basic information

About MCP Play Sound Server

Model Context Protocol server that provides audio playback functionality for AI agents. Play notification sounds when coding tasks complete. Early version/proof of concept - macOS only.

MCP Play Sound Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "play-sound-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

MCP Play Sound Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Play Sound Server?

MCP Play Sound Server is a Model Context Protocol server that provides audio playback for AI agents, enabling them to play sound notifications when coding tasks are completed. It is currently tested on macOS and is an early proof of concept.

How to use MCP Play Sound Server?

Clone the repository, set up a Python virtual environment, and install the package with pip install -e ".[dev]". Then configure Claude Desktop by adding a JSON entry to claude_desktop_config.json with the command uv and appropriate args pointing to the server directory. Restart Claude Desktop and ask the assistant to play a notification sound.

Key features of MCP Play Sound Server

Plays audio notifications when AI tasks complete
Bundled default sound for immediate use
Supports custom audio files (WAV, MP3, FLAC, OGG, M4A)
Automatically falls back to default sound if custom audio fails
Works on macOS using AFPlay and SimpleAudio
Configurable volume level and audio output device

Use cases of MCP Play Sound Server

Alert the user when a long-running coding task finishes
Play a custom sound to indicate an error or milestone
Test audio playback and list available system devices
Integrate audio feedback into AI‑assisted development workflows

Frequently asked questions

Is this server compatible with Windows or Linux?

No, it is currently tested only on macOS. Future versions may support additional platforms.

What audio formats are supported for custom sound files?

Custom audio files can be in WAV, MP3, FLAC, OGG, or M4A format.

How can I set a custom sound to play?

Set the `CUSTOM_SOUND_PATH` environment variable or pass the `custom_sound_path` parameter when calling the `play_notification_sound` tool.

How do I control the playback volume?

Set the `VOLUME_LEVEL` environment variable to a value between 0.0 and 1.0; the default is 0.8.

What happens if a custom sound file cannot be played?

The server automatically falls back to the default bundled sound if the custom audio fails.

Comments

More Other MCP servers

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi