How to Generate Music from the Terminal with Claude Code and Suno MCP

How to Generate Music from the Terminal with Claude Code and Suno MCP

If you already live in the terminal, switching to a browser just to prototype a song idea can feel like breaking flow. The Claude Code + Suno MCP setup gives you a practical way to ask for lyrics, styles, covers, extensions, and stems from inside a Claude Code session.

What you can do

The useful part of this workflow is not that it hides music generation behind magic. It exposes a small set of concrete MCP tools to Claude Code, so you can describe an audio task in natural language and let the assistant pick the right tool.

  • Generate a full song from a short description with suno_generate_music.
  • Write your own lyrics and specify style or vocals with suno_generate_custom_music.
  • Continue an existing song from a specific timestamp with suno_extend_music.
  • Create a cover in a different style with suno_cover_music.
  • Mash up two songs with suno_mashup_music.
  • Separate vocals and accompaniment with suno_stems_music.
  • Generate lyrics with suno_generate_lyrics.
  • Save reusable voice styles with suno_create_persona.

That is enough for a surprisingly complete builder workflow: draft an idea, generate a first version, iterate on the chorus, try a cover style, and split stems for downstream editing.

How it works

Claude Code supports MCP servers, and the Suno integration is exposed as an HTTP MCP server at https://suno.mcp.acedata.cloud/mcp. You add that server to Claude Code and pass an Ace Data Cloud API token as an authorization header. After that, Claude Code can discover the Suno tools and call them when your prompt requires music generation or editing.

The important detail is that this is a local developer configuration step, not an SDK install. You are teaching Claude Code where the MCP server is and how to authenticate to it.

Configure Suno MCP in Claude Code

Run the following command in your terminal, replacing YOUR_TOKEN with your Ace Data Cloud API token:

claude mcp add suno --transport http https://suno.mcp.acedata.cloud/mcp \
  -H "Authorization: Bearer YOUR_TOKEN"

There is one small but easy-to-miss detail: the header flag must be uppercase -H. A lowercase -h is interpreted as help, not as a header parameter.

Once the server is added, verify the connection:

claude mcp list

You should see the suno server marked as connected. If it is not connected, check the token value, the MCP URL, and the exact spelling of the Authorization: Bearer header.

Choose the right scope

Claude Code lets you decide where the MCP configuration should live. Without -s, the default is local, which applies only in the current directory when running commands. That is fine for a one-off experiment, but it is usually worth being explicit.

  • local: no -s or -s local; stored in ~/.claude.json; effective only for the current project directory.
  • user: -s user; stored in ~/.claude.json; available globally across projects.
  • project: -s project; stored in .mcp.json in the project root; useful when a team wants to share the MCP setup.

For team projects, -s project is useful because the configuration can be committed with the repository. Do not commit a real token to a public repo. Use environment-variable placeholders instead, then let each developer provide their own secret locally.

Try a few terminal-first prompts

After the setup, you do not need to remember the tool names for every task. In a Claude Code session, ask for the outcome you want:

Generate a folk song about a programmer working late at night

If you want more control, split the request into a writing step and a generation step:

Write lyrics about spring rain, then generate a soft pop song with those lyrics

For iteration, refer back to an existing result:

The chorus sounds good. Extend the song from the chorus section.

Or try a transformation-style workflow:

Cover the previously generated song in a jazz style

This is where the MCP approach feels practical for builders. You can keep context in one assistant session: the prompt, the lyrics, the generated result, and the next edit all live in the same working conversation.

A minimal builder workflow

  1. Add the Suno MCP server with claude mcp add suno.
  2. Confirm it with claude mcp list.
  3. Ask Claude Code to draft lyrics for a specific scene, mood, or audience.
  4. Generate the first song with a clear style instruction.
  5. Iterate with cover, extend, mashup, or stems depending on what you need next.

For a prototype, that may be enough. For a repeatable internal tool, the same pattern can become a documented workflow for content, game audio sketches, podcast jingles, or product demo soundtracks.

Wrap-up

Claude Code + Suno MCP is a compact setup: one MCP server URL, one bearer token header, and a handful of music-focused tools. The main win is workflow continuity. You can stay in the terminal, keep the creative brief close to your code or project notes, and iterate without treating audio generation as a separate browser task.

Read the source documentation here: Claude Code integration with Suno MCP.

Comments

Post a Comment

Popular posts from this blog

Artistic QR Code API Integration Guidance

Image
Artistic QR code is an innovative technological product that combines QR codes with beautiful background images, creating practical and visually appealing works. They not only possess the functionality of traditional QR codes, allowing quick scanning and recognition by smart devices, but also incorporate artistic elements to enhance visual appeal and brand recognition. Some artistic QR codes are even generated by artificial intelligence, fully leveraging modern technology to demonstrate unparalleled innovation and uniqueness. This makes artistic QR codes widely applicable in areas such as brand marketing and advertising. In simple terms, artistic QR codes are the perfect combination of QR code scanning and artistic aesthetics. They not only provide the function of information transmission, but also enhance the user's visual experience, making each scan a delightful artistic enjoyment. Overview of Artworks Let's take a look at a few QR code works: How are they? These are ar...
Read more
Image
Nexior is an open-source project on GitHub that allows us to deploy our AI application site with one click, including AI Q&A, Midjourney drawing, knowledge base Q&A, artistic QR codes, and more. There is no need to develop AI systems, purchase AI accounts, worry about API support, or configure payment systems. It comes with zero startup costs and allows you to earn income through AI without risk. This article will introduce the deployment process of the Nexior project on Vercel. Without any programming skills, you can deploy your AI site in a few minutes and easily generate revenue. Preparation First, open the Nexior GitHub repository at: https://github.com/AceDataCloud/Nexior , then register or log in to your GitHub account. Click Fork to clone the code to your local repository, as shown below: After completing the Fork, we will get our personal repository, as shown below: In this example, the account is Germey, so we can see that we have Forked to the Germey user, wit...
Read more

How to Configure Claude Code with CC Switch and Ace Data Cloud

Image
If you use Claude Code across a terminal, VS Code, or remote development setup, the awkward part is often not the model itself but the configuration: where should requests go, where should the token live, and how do you switch providers without editing files by hand? This guide walks through a practical setup using CC Switch as the graphical configuration manager and Ace Data Cloud as the Anthropic-compatible base URL. The goal is simple: configure Claude Code once, verify the active endpoint, and keep the setup easy to change later. What you can do With the setup described in the Ace Data Cloud documentation, you can: Manage Claude Code provider configuration through a desktop UI instead of manually editing settings.json . Store an Ace Data Cloud provider with ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN . Switch the active Claude Code provider from CC Switch without rewriting your configuration every time. Use the same provider configuration from the terminal an...
Read more