Skip to main content
Glama

SoundCloud MCP

PyPI version License: MIT Python 3.10+ 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

Related MCP server: Mixtape

Requirements

Register your SoundCloud app

Field

What to enter

App name

SoundCloud MCP (or anything descriptive)

Description

Personal MCP server for uploading AI-generated music to my SoundCloud account

Website

https://github.com/David-J-Shibley/soundcloud-mcp (optional)

Redirect URI

http://127.0.0.1:8765/callback (must match exactly)

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

Tool

Description

soundcloud_get_me

Your SoundCloud profile

soundcloud_list_my_tracks

List your uploaded tracks

soundcloud_get_track

Track details by ID

soundcloud_upload_track

Upload MP3/WAV/FLAC with metadata

soundcloud_update_track

Edit title, description, tags, artwork

soundcloud_delete_track

Remove a track

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

Variable

Default

Description

SOUNDCLOUD_CLIENT_ID

—

From soundcloud.com/you/apps

SOUNDCLOUD_CLIENT_SECRET

—

From soundcloud.com/you/apps

SOUNDCLOUD_REDIRECT_URI

http://127.0.0.1:8765/callback

Must match app settings

SOUNDCLOUD_TOKEN_FILE

~/.soundcloud-mcp/tokens.json

OAuth token storage

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.

Available Tools

7 tools
soundcloud_create_playlistB

Create a SoundCloud playlist (album/set) with ordered tracks and optional cover art.

Inputs: params (required). Returns: result

soundcloud_delete_trackC

Delete a track from your SoundCloud account.

Inputs: params (required). Returns: result

soundcloud_get_meA

Get your authenticated SoundCloud profile.

Inputs: no named parameters. Returns: result

soundcloud_get_trackA

Get details for a specific track by ID.

Inputs: params (required). Returns: result

soundcloud_list_my_tracksB

List tracks uploaded to your SoundCloud account.

Inputs: params (required). Returns: result

soundcloud_update_trackC

Update metadata for an existing track.

Inputs: params (required). Returns: result

soundcloud_upload_trackA

Upload an audio file to SoundCloud.

Requires OAuth login (run soundcloud-mcp-auth once). Uses your Artist Pro API credentials.

Inputs: params (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (profile, track CRUD, playlist creation, track listing). There is no overlap or ambiguity between tool purposes.

    Naming Consistency5/5

    All tools follow the pattern 'soundcloud_verb_noun' with clear verbs (create, delete, get, list, update, upload). The pattern is uniform and predictable.

    Tool Count5/5

    Seven tools cover the essential operations for a SoundCloud integration without being excessive. Each tool has a distinct role, and the count is well-scoped for the domain.

    Completeness3/5

    Core track and profile operations are covered, but missing playlist management (update, delete, get) and other common features like search or streaming. Gaps are notable but not severe for basic usage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables MCP clients to search SoundCloud and retrieve tracks, playlists, and users, as well as perform authenticated actions such as likes, reposts, follows, comments, playlist editing, and uploads with multi-account OAuth support.
      36
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Claude to search SoundCloud, curate and build playlists from a described mood or moment, and control playback by playing, skipping and liking songs. It also exposes the local desktop player's library and queue so requests like "make me something for a rainy afternoon and play it" are carried out end to end.
      2
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables an AI assistant to act as a user's account on the audio-sharing platform: browsing feeds and searching, uploading and editing tracks, managing sets, groups, profiles and messages. Requires a Premium account, with destructive actions gated behind client confirmation.
      51
      32 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Connects an AI assistant to the user's own SoundCloud account so they can search tracks by genre, tempo, key or release date, discover similar tracks and artists, and build private playlists in DJ-friendly order through natural language. It adds BPM, key and Camelot codes to every track and safeguards existing playlists by refusing destructive writes or deletions.
      23
      MIT