Audio File MCP App — Claude Code MCP server
Inspect local audio in an agent window with playback, metadata, loudness readings, and a spectrogram. Useful when you want to discuss a specific part of a recording.
claude mcp add audio-file-mcp-app -- npx -y @counterpoint-studio/audio-file-mcp-appWhat Audio File MCP App does
Ask the host to open a local audio file by its absolute path. The app displays playback controls, a waveform, metadata, and a spectrogram; it also shares the playhead position and selected region with the model. Loudness readings include EBU R128 measures such as LUFS, LRA, and True Peak.
You can add labelled annotation lanes to mark events or show analysis intervals. Provide the data through annotations, or point to a JSON file with annotationsPath. The server runs locally over stdio and can open audio files accessible to the user account. That means an agent with tool access can open recordings on your machine, so host approval settings matter.
For Claude Code, add the server with claude mcp add audio-file-mcp-app -- npx -y @counterpoint-studio/audio-file-mcp-app. It launches the package through npx.
What it helps with
- play a local audio file inside an agent host
- inspect a recording’s EBU R128 loudness readings
- view frequency content in a spectrogram
- mark events and intervals on an audio timeline
Example prompts for the agent
- Open
/Users/me/Music/track.wavso I can listen and inspect its spectrogram. - Check the loudness of
/Users/me/Music/track.wavand mark the audible events on its timeline.
How to install Audio File MCP App
Platform CLI
claude mcp add audio-file-mcp-app -- npx -y @counterpoint-studio/audio-file-mcp-appPlatform CLI
codex mcp add audio-file-mcp-app -- npx -y @counterpoint-studio/audio-file-mcp-appConfig file
{
"mcpServers": {
"audio-file-mcp-app": {
"command": "npx",
"args": [
"-y",
"@counterpoint-studio/audio-file-mcp-app"
]
}
}
}Config file
{
"servers": {
"audio-file-mcp-app": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@counterpoint-studio/audio-file-mcp-app"
]
}
}
}Platform CLI
gemini mcp add audio-file-mcp-app npx -y @counterpoint-studio/audio-file-mcp-appStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Audio File MCP App
How do I install Audio File MCP App in Claude Code?
Run claude mcp add audio-file-mcp-app -- npx -y @counterpoint-studio/audio-file-mcp-app. This registers the server and launches it through npx.
What does Audio File MCP App do?
It opens local audio in an interface with playback, metadata, loudness measurements, and a spectrogram. The model also receives the playhead position and selected region.
Can I mark sections of an audio file?
Yes. Send labelled timeline lanes and time spans using annotations, or provide a JSON file with annotationsPath.
