MCP.so
Sign In

MCP Play Sound Server

@davidteren

Repository

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.

Basic information

Category

Other

License

MIT license

Runtime

python

Transports

stdio

Publisher

davidteren

Config

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

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

Tools

No tools detected

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

FAQ from MCP Play Sound Server

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

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K