Step-by-step guide to generate Suno AI music from Claude. Add the SunoBoard connector in Claude.ai, use an API key in Claude Code, or run the open-source MCP in Cursor.
01Is there an official Suno integration for Claude?
Not from Suno itself. Claude talks to outside tools through the Model Context Protocol (MCP), and Suno does not publish an MCP server. SunoBoard fills that gap: it runs a hosted MCP server at https://mcp.sunoboard.com/mcp that Claude can call to generate songs, check their status and return the audio link.
You can connect it in four places. Pick the one you already use. The setup is different, but the result is the same: you ask for a song in plain language and the track lands in your SunoBoard library.
02Claude.ai (web and desktop app), no API key
This is the fastest route and it works on the free plan. Create a SunoBoard account with Google, then in Claude.ai open Settings → Connectors → Add custom connector. Paste https://mcp.sunoboard.com/mcp, click Add, and approve the SunoBoard authorization screen. That is all.
Open a new chat and test it with a prompt that asks Claude to wait for the result, so you get a playable link in the same answer.
Use SunoBoard to make a chill lo-fi track for studying, wait until it's ready and give me the link.
03Claude Code (terminal)
Claude Code connects with a SunoBoard API key. Create one in Settings → API Keys (keys start with sb_ and come with the Pro plan), then add the server once:
- Check it worked
run /mcp inside Claude Code and look for "sunoboard" with its tools listed. - Best for
developers adding music or sound effects to a game or app without leaving the editor.
claude mcp add --transport http sunoboard https://mcp.sunoboard.com/mcp --header "Authorization: Bearer sb_YOUR_KEY"
04Claude Desktop with a config file
If you prefer the config file over the connector screen, add SunoBoard to claude_desktop_config.json with the same sb_ key and restart Claude Desktop:
{ "mcpServers": { "sunoboard": { "url": "https://mcp.sunoboard.com/mcp", "headers": { "Authorization": "Bearer sb_YOUR_KEY" } } } }
05Cursor, VS Code, Windsurf and Zed
Any MCP client can use the hosted URL plus the Authorization header shown above. If you already pay for a sunoapi.org key and want to run everything locally, use the open-source package @yellowkode/suno-mcp (MIT) instead:
{ "mcpServers": { "suno": { "command": "npx", "args": ["-y", "@yellowkode/suno-mcp"], "env": { "SUNO_API_KEY": "your-sunoapi.org-key" } } } }
06Troubleshooting
- Claude says it has no music tool
start a new chat after adding the connector, and make sure it is switched on in the chat’s tools menu. - Authorization loop
sign in to sunoboard.com in the same browser first, then add the connector again. - 401 in Claude Code or Cursor
the key must be sent as "Bearer sb_…". Regenerate it in Settings if you lost it. - Quota message
the free plan includes 2 free credits a month (up to 4 songs). A Suno request uses 1 credit and returns two variations; other models cost more credits.