Gemini CLI Integration with Suno MCP
📘 Complete Guide: Using Ace Data Cloud MCP in Gemini CLI →
Suno supports generating songs based on lyrics or style descriptions. After integrating MCP with Gemini CLI, you can write songs, create BGM, continue writing, cover, or extract vocals in conversations.
¶ Obtain API Token
Register an account on the Ace Data Cloud platform and copy the API Token from the homepage—one Token can be used for all MCP Servers. For detailed steps, see the Complete Guide.

¶ Configuration
Edit configuration: one-click command line addition (recommended)
gemini mcp add suno \
--transport http \
https://suno.mcp.acedata.cloud/mcp \
--header "Authorization: Bearer yourToken"
Or manually edit ~/.gemini/settings.json:
{
"mcpServers": {
"suno": {
"httpUrl": "https://suno.mcp.acedata.cloud/mcp",
"headers": { "Authorization": "Bearer yourToken" }
}
}
}
The next time you start a gemini session, you can use the Suno tool.
¶ Usage Examples
Help me write a 30-second upbeat Chinese pop song with the theme "Camping with friends on the weekend."
Use Suno to create a lofi hip hop BGM for a programming tutorial video, without vocals.
Extend this song (link xxx) from 30 seconds to 90 seconds, maintaining the original melody style.
¶ Tools
| Tool | Description |
|---|---|
| generate | Generate a song from a description |
| custom | Generate a song with custom lyrics + style |
| extend | Extend an existing song to be longer |
| cover | Cover a song in a new style |
| lyrics | Generate only lyrics |
| upload_to_persona | Register Persona with vocal audio |
| query | Query historical generation results |
