play_soundLABSCO SUMMARY
Ambient status for long-running work.
This does one thing and does not pretend otherwise: three named sounds an agent can trigger at the moments you would otherwise sit and watch for. Read the version note before installing — the project is tested on Python 3.8 to 3.11 and reports async failures above that.
What it is
A Python server that plays local audio files on your machine. An agent calls it after a long command or a failure, and you hear the outcome instead of watching for it.
What you get
- A sound played for a named event — completion, error or notification — or from a custom file path —
play_sound - The sound files currently available —
list_available_sounds - The bundled sounds copied into your user config directory —
install_to_user_dir
Requirements
No account and no key. Tested with Python 3.8 to 3.11; the project reports BrokenResourceError and TaskGroup failures on 3.12 and newer. Install from a clone of the repository with pipx install ., which puts the mcp-sound-tool command on your PATH for the client to launch over stdio. Sound files live in the sounds directory as completion.mp3, error.mp3 and notification.mp3.
Setup effort
Build from source — git clone https://github.com/tijs/py-sound-mcp
USE CASES
01
Walking away from a long build
Have the agent play the completion sound when the command returns, so you come back at the right moment rather than checking.
02
Hearing a failure immediately
Trigger the error sound on a non-zero exit, so a broken run does not sit unnoticed in a scrollback.
03
Using your own sounds
Check which files the server can currently see before wiring the events to them.
04
Setting it up on a new machine
Copy the bundled sounds into your user config directory in one call.
3 tools
Listed in project docs. Your client may show a different list.
list_available_soundsinstall_to_user_dirBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/tijs/py-sound-mcp
cd py-sound-mcp
pipx install .MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"sound": {
"command": "mcp-sound-tool",
"args": [],
"type": "stdio",
"pollingInterval": 5000,
"startupTimeout": 10000,
"restartOnFailure": true
}
}
}
