Sonilo Music & Sound Effects — Claude Code MCP server: install guide
Scores licensed music and sound effects tailored to the pacing of your video clips. Useful when you need ready-to-use audio without manual synchronization.
claude mcp add --env SONILO_API_KEY=<SONILO_API_KEY> --env SONILO_API_URL=<SONILO_API_URL> --env SONILO_MCP_BASE_PATH=<SONILO_MCP_BASE_PATH> --env TIME_OUT_SECONDS=<TIME_OUT_SECONDS> --transport stdio sonilo-music-sound-effects -- uvx sonilo-mcpWhat Sonilo Music & Sound Effects does
This server connects AI assistants to the Sonilo media API via MCP. Its primary tool, video_to_music, inspects your cut to compose background tracks that mirror scene edits and visual pacing. The output duration aligns with the source video. For Foley and ambience, video_to_sfx builds sound effects pegged to on-screen events or specific timestamps.
Running the server requires uvx and an active SONILO_API_KEY token. If you intend to preview generated audio through play_audio, PortAudio must be present on your OS. Without that system library, local playback fails. Other tools continue to work.
Every asset carries Shutterstock licensing cleared for commercial distribution. You can also separate finished scores into drum, bass, and vocal stems via stems=true. Multiple creative variations are supported in one call.
What it helps with
- score custom background music matching video cuts and pacing
- generate contextual sound effects aligned with visual actions
- create standalone sound effects from text descriptions
- isolate drums, bass, and vocal stems from generated tracks
Example prompts for the agent
- Compose background music matching the cuts in
promo.mp4 - Generate realistic sound effects for the action in
trailer.mp4 - Create a 20-second synth track with separated stems
How to install Sonilo Music & Sound Effects
Platform CLI
claude mcp add --env SONILO_API_KEY=<SONILO_API_KEY> --env SONILO_API_URL=<SONILO_API_URL> --env SONILO_MCP_BASE_PATH=<SONILO_MCP_BASE_PATH> --env TIME_OUT_SECONDS=<TIME_OUT_SECONDS> --transport stdio sonilo-music-sound-effects -- uvx sonilo-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sonilo-mcp <command>
Platform CLI
codex mcp add sonilo-music-sound-effects --env SONILO_API_KEY=<SONILO_API_KEY> --env SONILO_API_URL=<SONILO_API_URL> --env SONILO_MCP_BASE_PATH=<SONILO_MCP_BASE_PATH> --env TIME_OUT_SECONDS=<TIME_OUT_SECONDS> -- uvx sonilo-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sonilo-mcp <command>
Config file
{
"mcpServers": {
"sonilo-music-sound-effects": {
"command": "uvx",
"args": [
"sonilo-mcp"
],
"env": {
"SONILO_API_KEY": "<SONILO_API_KEY>",
"SONILO_API_URL": "<SONILO_API_URL>",
"SONILO_MCP_BASE_PATH": "<SONILO_MCP_BASE_PATH>",
"TIME_OUT_SECONDS": "<TIME_OUT_SECONDS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sonilo-mcp <command>
Config file
{
"servers": {
"sonilo-music-sound-effects": {
"type": "stdio",
"command": "uvx",
"args": [
"sonilo-mcp"
],
"env": {
"SONILO_API_KEY": "<SONILO_API_KEY>",
"SONILO_API_URL": "<SONILO_API_URL>",
"SONILO_MCP_BASE_PATH": "<SONILO_MCP_BASE_PATH>",
"TIME_OUT_SECONDS": "<TIME_OUT_SECONDS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sonilo-mcp <command>
Platform CLI
gemini mcp add -e SONILO_API_KEY=<SONILO_API_KEY> -e SONILO_API_URL=<SONILO_API_URL> -e SONILO_MCP_BASE_PATH=<SONILO_MCP_BASE_PATH> -e TIME_OUT_SECONDS=<TIME_OUT_SECONDS> sonilo-music-sound-effects uvx sonilo-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from sonilo-mcp <command>
Step 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 Sonilo Music & Sound Effects
How to install Sonilo Music & Sound Effects in Claude Code?
Run claude mcp add sonilo-mcp -e SONILO_API_KEY=<SONILO_API_KEY> -- uvx sonilo-mcp using your personal Sonilo API key.
What does Sonilo Music & Sound Effects do?
It adds MCP tools to generate commercially cleared music and audio effects synced to your video duration.
Is PortAudio mandatory for all server tools?
PortAudio is strictly needed for the play_audio playback tool. Music generation, SFX creation, and stem exports function without it.
