"List my Boomplay playlists."
↳ fym_library_playlists
CLAUDE DESKTOP
List my Boomplay playlists.
Claude · thinking…
↳ fym_library_playlists
✓ Done
Answered from your connected account.
Boomplay, inside your AI assistant.
Connect Boomplay to your Free Your Music account once. Then ask Claude, Cursor, Cline or Claude Code to read your playlists, move them to another service and keep them in sync.
Install in
npx -y @freeyourmusic/mcp install --host=claude-desktopWrites to ~/Library/Application Support/Claude/claude_desktop_config.json
Quit Claude Desktop fully (cmd+Q on macOS) and open it again. The tools show up under the freeyourmusic server.
Ask about your Boomplay music
"Search Boomplay for the newest Amapiano songs."
↳ fym_search
"Show the songs in my Boomplay playlist Favourites."
↳ fym_library_playlists↳ fym_library_tracks
What works on {serviceName}
Read · Search · Edit playlists
The MCP server reads your Boomplay playlists and searches the Boomplay catalogue. It does not edit Boomplay playlists.
Set up Boomplay in three steps
- Install the MCP server in your AI app with the command below, then restart the app.
- Ask your assistant to sign you in to Free Your Music, and approve the code in your browser.
- Ask it to connect Boomplay, and sign in to Boomplay in the browser tab that opens.
Install it in your AI app
Install in
npx -y @freeyourmusic/mcp install --host=claude-desktopWrites to ~/Library/Application Support/Claude/claude_desktop_config.json
Quit Claude Desktop fully (cmd+Q on macOS) and open it again. The tools show up under the freeyourmusic server.
More services, same server
See every tool of the Free Your Music MCP server
Free and Pro
Free
In the Free Your Music web app and the mobile apps: connect your services, move playlists, liked songs, albums and artists with no song limit, pick replacements for songs that did not match, use Stats and export the songs that did not move.
Pro
The MCP server and the CLI. Keep transfers in sync. Edit, sort, shuffle, dedupe, split, merge and restore playlists. Playlist insights.
Boomplay MCP: common questions
What does the Boomplay MCP server do?
It lets an AI assistant use your Boomplay account through Free Your Music. MCP (Model Context Protocol) is the way apps like Claude and Cursor call outside tools. You ask in plain words, and the assistant picks the Free Your Music tools it needs.
How do I connect Boomplay to Claude?
Run npx -y @freeyourmusic/mcp install --host=claude-desktop (or --host=claude-code) and restart Claude. Ask Claude to sign you in to Free Your Music and approve the code in your browser. Then ask it to connect Boomplay.
Does it work with Cursor and Cline too?
Yes. One server works in Claude Desktop, Claude Code, Cursor and Cline. Install it once per app. They all share one Free Your Music sign-in on your computer, and your Boomplay connection lives in your Free Your Music account, so you connect Boomplay only once.
What can my assistant do with Boomplay?
It can list your Boomplay playlists and read the songs in each one.
It can search the Boomplay catalogue, for example to find the right version of a song that did not match.
Is the Boomplay MCP server free?
No. The Boomplay MCP server is part of Free Your Music Pro, together with the CLI, auto-sync, the playlist tools and playlist insights. Transfers in the Free Your Music web app and the mobile apps stay free, with no song limit.
Is this an official Boomplay server?
No. Free Your Music builds it independently. It reaches Boomplay through the account you connect to Free Your Music. To use it, install the @freeyourmusic/mcp package shown on this page.
Where does the server run?
On your computer, with Node.js. Your AI app starts it and talks to it over stdio, and it calls the Free Your Music API over HTTPS. You do not paste a server URL.
Can I connect two Boomplay accounts?
Yes. Each connected account has its own id. Tell the assistant which Boomplay account you mean, for example by its name, and it picks the right one from your account list.
Setup guides per AI app
Privacy
The CLI and the MCP server run on your computer. They call the Free Your Music API over HTTPS with your account session, which sits in ~/.fym/credentials.json and only your user can read. Your music service logins stay encrypted on Free Your Music servers and never reach your AI app. Tool results do go to your AI app, and what it does with them depends on its settings and its model provider.
Your AI app or terminal→Free Your Music API (HTTPS)→Your music services
Give your assistant the keys to your music.
Copy one command, restart your AI app and ask it to sign you in.
Install in
npx -y @freeyourmusic/mcp install --host=claude-desktopWrites to ~/Library/Application Support/Claude/claude_desktop_config.json
Quit Claude Desktop fully (cmd+Q on macOS) and open it again. The tools show up under the freeyourmusic server.