SoundCloud MCP
Allows uploading and managing tracks on SoundCloud, including uploading MP3/WAV/FLAC files with metadata, updating track details, listing tracks, and deleting tracks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SoundCloud MCP Upload track.mp3 with title 'My Song' and tags 'electronic'"
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.
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
Related MCP server: Mixtape
Requirements
Python 3.10+
SoundCloud Artist Pro account
A registered SoundCloud API app (soundcloud.com/you/apps)
Register your SoundCloud app
Field | What to enter |
App name |
|
Description |
|
Website |
|
Redirect URI |
|
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-authInstall 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 .envAuthenticate (one time)
soundcloud-mcp-authTokens 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 |
| Your SoundCloud profile |
| List your uploaded tracks |
| Track details by ID |
| Upload MP3/WAV/FLAC with metadata |
| Edit title, description, tags, artwork |
| Remove a track |
Example workflow (Suno → SoundCloud)
Generate a song with suno-mcp
Download the MP3 with
suno_download_songUpload with soundcloud-mcp:
Upload ~/Downloads/suno/my-song.mp3 to SoundCloud as "My New Track" with tags "electronic ai-generated"Configuration
Variable | Default | Description |
| — | From soundcloud.com/you/apps |
| — | From soundcloud.com/you/apps |
|
| Must match app settings |
|
| OAuth token storage |
Troubleshooting
Blank/white OAuth page — Redirect URI mismatch. In soundcloud.com/you/apps, set exactly:
http://127.0.0.1:8765/callbackUse 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 toolssoundcloud_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
Scored across 7 tools
Each tool targets a distinct resource and action (profile, track CRUD, playlist creation, track listing). There is no overlap or ambiguity between tool purposes.
All tools follow the pattern 'soundcloud_verb_noun' with clear verbs (create, delete, get, list, update, upload). The pattern is uniform and predictable.
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.
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
Related MCP Connectors
SoundCloud MCP server for ChatGPT, Claude and any AI agent: list tracks, get play and like counts, list comments, read direct messages, check if you messaged a profile and update track details in your own SoundCloud account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to SoundCloud yourself; Cotlet does not store your password and you need no SoundCloud API key. About the official SoundCloud API: SoundCloud has a public API, but you need an Artist Pro subscription to register an app and get credentials (checked 30 Oct 2026). It uploads tracks, edits track details, builds playlists and posts comments, but its guide lists no Insights for a period and no direct messages. Setup and FAQ: https://cotlet.dev/integrations/soundcloud-api-mcp-server
Publish and schedule social posts, upload media, and review analytics through OAuth.
Full Spotify Web API coverage - albums, artists, playlists, player controls, and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.36MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.2MIT

hearthisofficial
AlicenseBqualityCmaintenanceEnables 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.5132 npmMIT- AlicenseAqualityBmaintenanceConnects 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.23MIT