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.

Get Ace Data Cloud API Key

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