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

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]"

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"
      ]
    }
  }
}

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

Model Context Protocol by Anthropic
Python audio library maintainers

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

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

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 -
18
TypeScript
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 -
3
Python
MIT License
Cursor Sound MCP
bcharleson
A
security
F
license
A
quality
Plays sound effects when Cursor AI completes code generation, providing audio feedback for a more interactive coding experience.
Last updated -
1
2
TypeScript
MCP Sound Tool
tijs
-
security
A
license
-
quality
A Model Context Protocol implementation that plays sound effects (completion, error, notification) for Cursor AI and other MCP-compatible environments, providing audio feedback for a more interactive coding experience.
Last updated -
1
Python
MIT License

View all related MCP servers

Appeared in Searches

A software or tool called Desktop Commander

MCP Play Sound Server