Which integrations are available for this server?

Enables AI music generation through [Suno](/mcp/servers/integrations/suno)'s platform, including creating songs with custom lyrics and style tags, generating songs from text descriptions, checking generation status, managing credits, and downloading MP3 files.

How do I use Suno MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type `@` followed by the MCP server name and your instructions, e.g., "`@Suno MCP` create a happy birthday song with cheerful pop style" That's it! The server will respond to your query, and you can continue using it as needed. Here is a [step-by-step guide with screenshots](https://glama.ai/blog/2025-07-08-how-to-install-and-use-mcp-servers).

Suno MCP

An MCP (Model Context Protocol) server for generating music with Suno.

Features

Generate songs with custom lyrics and style tags
Generate from description - let Suno AI write the lyrics
Wait for completion and get audio URLs with markdown embeds
Download MP3s to local folders
Auto-refresh tokens when they expire

Requirements

Node.js 18+
BrowserOS running on port 9000 with an active Suno session
A Suno account (free or paid)

Installation

npm install

Usage with Claude Code

Add to your .mcp.json:

{ "suno": { "command": "node", "args": ["/path/to/suno-mcp/src/index.js"] } }

Tools

Tool	Description
`suno_generate_song`	Generate with custom lyrics and style
`suno_generate_from_description`	AI writes lyrics from a description
`suno_wait_for_songs`	Wait for completion, returns URLs + markdown
`suno_check_status`	Check generation status
`suno_get_credits`	Get account credits info
`suno_get_recent`	List recent songs
`suno_download_song`	Download MP3 to a folder

How It Works

Authentication

Suno uses Clerk for auth with short-lived JWT tokens (~1 hour). The client:

Checks the __session cookie from BrowserOS via Chrome DevTools Protocol (CDP)
If expired, reloads the Suno page to trigger a token refresh
Captures the fresh token from network requests

Song Generation

Direct API calls fail due to hCaptcha. Instead, we:

Connect to the Suno page via CDP
Inject JavaScript to fill the form (lyrics, style)
Click the Create button (CAPTCHA runs invisibly in browser context)
Capture song IDs from the network response

Example

// Generate a song const result = await suno_generate_song({ lyrics: "[Verse]\nHello world\n\n[Chorus]\nThis is a test", style: "indie folk, acoustic, male vocals" }); // Wait for it to complete const songs = await suno_wait_for_songs({ ids: result.songIds }); // Download it await suno_download_song({ songId: songs[0].id, folder: "./downloads" });