Suno-MCP Server

You can run and integrate the Suno-MCP Server to enable Suno AI music generation through MCP-capable clients like Claude Desktop and Reaper MCP. This server provides login, music generation from prompts, lyrics and style options, and track download, all programmatically accessible via MCP interfaces.

How to use

You access Suno-MCP functionality by running the server locally and connecting your MCP client to it. The server supports two startup methods: running via Python with a module entry point, or using an installed package that provides a ready-to-run command. The client can perform login to Suno AI, generate tracks with prompts and styles, monitor generation status, and download resulting MP3 files. You can integrate this into your production workflow with your preferred MCP client such as Claude Desktop or Reaper MCP.

How to install

Prerequisites you need to prepare before starting:

# 1) Install Python 3.10 or newer
# 2) Install Claude Desktop with MCP support (for your MCP client)
# 3) Create or use a Suno AI account (free tier)
# 4) Optional: Reaper DAW for a complete production pipeline

Install the Suno-MCP server dependencies and verify the setup by running the server in test mode.

cd D:\Dev\repos\suno-mcp
pip install -r requirements.txt

# Install Playwright browsers for browser automation
playwright install chromium

# Test the server locally
python -m suno_mcp.server

Configure your MCP client to connect to the Suno-MCP server. You have two options depending on your environment.

# Windows example using Python module entry point
{
  "mcpServers": {
    "suno-mcp": {
      "command": "python",
      "args": ["-m", "suno_mcp.server"],
      "env": {
        "PYTHONPATH": "D:\\Dev\\repos\\suno-mcp\\src"
      }
    }
  }
}

# Alternative: use the installed package command
{
  "mcpServers": {
    "suno-mcp": {
      "command": "suno-mcp",
      "args": [],
      "env": {}
    }
  }
}

Restart your MCP client after saving the configuration to ensure it connects to the Suno-MCP server.

Additional sections

Configuration notes and run-time details you may need when operating the Suno-MCP server.

# Windows/Python module variant (example)
{
  "mcpServers": {
    "suno-mcp": {
      "command": "python",
      "args": ["-m", "suno_mcp.server"],
      "env": {
        "PYTHONPATH": "D:\\Dev\\repos\\suno-mcp\\src"
      }
    }
  }
}

# Alternative variant (installed package)
{
  "mcpServers": {
    "suno-mcp": {
      "command": "suno-mcp",
      "args": [],
      "env": {}
    }
  }
}

Usage patterns you can follow with the Suno-MCP server include initiating a login, sending a text prompt to generate a track, optionally including style and lyrics, polling for status, and downloading the resulting MP3 file. You can also integrate with a DAW workflow for complete production, such as importing the track into a project and applying mixing or mastering steps.

Security and troubleshooting

Security: Credentials are handled securely during login, and downloads use safe, defined paths. Browser automation runs in isolated contexts to minimize risk.

Troubleshooting tips you may find helpful include verifying credentials, ensuring the Suno AI login works on the free tier, checking that generation requests complete within expected timeframes, and confirming you have correct write permissions for download folders.

If you encounter a browser-related issue during development or debugging, you can run the browser in headful mode to observe interactions and identify UI elements more easily.

Available tools

suno_open_browser

Launch browser automation to interact with Suno AI UI for generation tasks.

suno_login

Authenticate with Suno AI using provided credentials.

suno_generate_track

Create a new music track from a text prompt, with optional style and lyrics.

suno_download_track

Download a completed track by its identifier, with optional stems.

suno_get_status

Check the current status of the Suno-MCP server and ongoing generations.

suno_close_browser

Clean up and close the browser automation session.

suno_studio_open

Open Suno Studio if supported by the beta tools.

suno_studio_close

Close Suno Studio and optionally save the session.

suno_studio_create_project

Create a new project in Suno Studio with specified template and settings.

suno_studio_generate_stem

Generate an AI stem for a given track in Studio.

suno_studio_wait_generation

Wait for a Studio generation process to complete.

suno_studio_arrange_track

Arrange a track on the Studio timeline.

suno_studio_set_bpm

Set the BPM for the Studio project.

suno_studio_create_sections

Create song sections in Studio (Intro, Verse, Chorus, etc.).

suno_studio_adjust_volume

Adjust the volume of a Studio track.

suno_studio_add_effect

Add an audio effect to a Studio track.

suno_studio_export_project

Export the Studio project to a chosen format.