SoundCloud MCP

MCP server for uploading and managing tracks on SoundCloud using the official API.

Use it from Cursor or Claude Desktop to upload MP3s, update metadata, and manage your catalog — pairs naturally with suno-mcp for generate → upload workflows.

Features

• Official SoundCloud API — OAuth 2.1 + PKCE, no browser scraping for uploads
• Upload tracks — MP3, WAV, FLAC with title, description, tags, artwork
• Manage library — list, get, update, delete tracks
• Token refresh — automatic OAuth token renewal

Requirements

• Python 3.10+
• SoundCloud Artist Pro account
• A registered SoundCloud API app (soundcloud.com/you/apps)

Register your SoundCloud app

The Website field is optional — it is not used for OAuth. The Redirect URI must match character-for-character.

Quick Start

Install from PyPI

pip install soundcloud-mcp
cp .env.example .env
# Edit .env with client_id and client_secret from soundcloud.com/you/apps
soundcloud-mcp-auth

Install from source

git clone https://github.com/David-J-Shibley/soundcloud-mcp.git
cd soundcloud-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env

Authenticate (one time)

soundcloud-mcp-auth

Tokens are saved to ~/.soundcloud-mcp/tokens.json.

If the browser page is blank/white, your redirect URI doesn't match — see Troubleshooting.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "soundcloud": {
      "command": "/absolute/path/to/soundcloud-mcp/.venv/bin/python",
      "args": ["-m", "soundcloud_mcp"],
      "cwd": "/absolute/path/to/soundcloud-mcp",
      "env": {
        "DYLD_LIBRARY_PATH": "/opt/homebrew/opt/expat/lib"
      }
    }
  }
}

Put credentials in .env in the project directory (recommended) — cwd lets the server load them automatically.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "soundcloud": {
      "command": "/absolute/path/to/soundcloud-mcp/.venv/bin/python",
      "args": ["-m", "soundcloud_mcp"],
      "cwd": "/absolute/path/to/soundcloud-mcp"
    }
  }
}

Tools

Example workflow (Suno → SoundCloud)

1. Generate a song with suno-mcp
2. Download the MP3 with suno_download_song
3. Upload with soundcloud-mcp:

Upload ~/Downloads/suno/my-song.mp3 to SoundCloud as "My New Track" with tags "electronic ai-generated"

Configuration

Troubleshooting

Blank/white OAuth page — Redirect URI mismatch. In soundcloud.com/you/apps, set exactly:

http://127.0.0.1:8765/callback

Use 127.0.0.1 not localhost, http:// not https://, no trailing slash.

Not authenticated — Run soundcloud-mcp-auth again.

Manual login — soundcloud-mcp-auth --no-browser prints the URL to paste into your browser.

Disclaimer

Unofficial project, not affiliated with SoundCloud. Use in accordance with SoundCloud's API Terms of Use.

Contributing

Issues and pull requests welcome on GitHub.

See PUBLISHING.md for PyPI release instructions.

License

MIT — see LICENSE.