@yellowkode/suno-mcp
MCP Server for Suno AI — Generate music directly from Claude, VSCode, Cursor, and any MCP-compatible client.
by YellowKode Academy · sunoboard.com
What is this?
@yellowkode/suno-mcp is an open-source Model Context Protocol (MCP) server that connects Claude and other AI assistants directly to the Suno AI music generation API.
Instead of manually calling the API, you can just tell Claude:
"Generate a dark ambient viking instrumental, slow drums, cinematic, no vocals"
...and Claude handles the full generation flow automatically.
Prerequisites
- Node.js 18+
- A Suno API key — two options:
The server auto-detects which API to use based on the key prefix. No extra config needed.
Quick start
# One-shot (no install needed)
SUNO_API_KEY=your_key npx @yellowkode/suno-mcp
# Or install globally
npm install -g @yellowkode/suno-mcp
Setup
Claude Desktop
Edit claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"suno": {
"command": "npx",
"args": ["@yellowkode/suno-mcp"],
"env": {
"SUNO_API_KEY": "your_key_here"
}
}
}
}
Claude Code (terminal)
claude mcp add suno \
-e SUNO_API_KEY=your_key_here \
-- npx @yellowkode/suno-mcp
Cursor / Cline (VSCode)
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"mcpServers": {
"suno": {
"command": "npx",
"args": ["@yellowkode/suno-mcp"],
"env": {
"SUNO_API_KEY": "your_key_here"
}
}
}
}
Available Tools
With a SunoBoard key (sb_...) you also get:
With a SunoBoard key, generate_music also accepts model = lyria-3-pro, minimax-2.6, stable-audio-2.5 or elevenlabs-music (plus duration_seconds where supported). Get your key at sunoboard.com/settings — or skip the install and add the hosted connector https://mcp.sunoboard.com/mcp (guide).
generate_music parameters
Usage Examples
Basic
"Generate a relaxing lo-fi hip hop track for studying"
Claude calls generate_music → wait_for_music and returns the audio URL.
Game development
"Generate dramatic battle music for an RPG boss fight, orchestral, no lyrics, intense"
Sound effects for your game (SunoBoard key)
"Here's my list of 20 sounds (footsteps on grass, coin pickup, door creak…). Generate each one with generate_sfx and save them to assets/audio/sfx"
Custom lyrics
"Generate a song with these lyrics: [paste lyrics], style: indie pop, female vocals"
With full control
"Generate music: prompt='cosmic meditation', style='deep space ambient, synth pads', model=V5, instrumental, weirdness=0.7"
Environment Variables
Visual Dashboard
Want to manage all your generated music visually?
SunoBoard gives you:
- Full history with inline player
- Organize by project (e.g. "Game OST", "YouTube Channel")
- Download MP3
- Credit tracking
- Regenerate with same parameters
Use a sb_ key to have all generations appear automatically in your dashboard.
Contributing
git clone https://github.com/YellowKode-Academy/suno-mcp
cd suno-mcp
npm install
npm run dev
Tests: npm test
License
MIT © YellowKode Academy · Wunka Tech
Built with ❤️ by Kelvin Biffi