The music MCP server that does the whole job.
One tool for every feature of the Free Your Music web app: your library, transfers, auto-sync, playlist tools, match fixes, insights, stats and exports. Part of Free Your Music Pro. Sign in once in your browser and ask.
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.
Pick your music service
Each service page has example prompts and shows what the server can do there. One server covers every service you connect.
The tools you will use most
The server has one tool for each operation of the Free Your Music web API, and each tool takes the input of that operation. Ask your assistant to list the freeyourmusic tools to see all of them. Every tool needs Free Your Music Pro.
| Sign-in and account | |
| fym_status | Your account, your Pro state and your connected services |
| fym_sign_in | Start the browser sign-in: a short code and a link |
| fym_services_connect | Connect a music service in the browser |
| fym_accounts_list | Your connected accounts, with their ids |
| Library and search | |
| fym_library_playlists | Every playlist of every account, in one list |
| fym_library_collections | The playlists, albums or artists of one account |
| fym_library_tracks | The songs in a playlist, an album or your liked songs |
| fym_search | Search the catalogue of a connected service |
| Transfers and sync | |
| fym_transfers_create | Start a transfer between two accounts: playlists, liked songs, albums and artists. Pro has no song limit |
| fym_transfers_progress | What your running transfers are doing right now |
| fym_transfers_pause | Pause a transfer; fym_transfers_resume starts it again |
| fym_transfers_set_sync | Turn auto-sync on or off for a transfer |
| fym_transfers_sync_now | Sync a transfer now |
| Playlist tools | |
| fym_playlists_create | Create a new, empty playlist |
| fym_playlists_preview | Preview a sort, shuffle, dedupe or split; changes nothing |
| fym_playlists_apply_tool | Apply that sort, shuffle, dedupe or split |
| fym_playlists_edits | Add, remove and move songs; rename; change the description |
| fym_playlists_merge | Merge playlists into a new one |
| fym_playlists_copy | Copy a playlist to another account or inside the same account |
| fym_playlists_restore | Go back to a saved version of a playlist |
| Songs that did not match | |
| fym_matches_unmatched | The songs a transfer could not match |
| fym_matches_search | Look for the right song on the destination service |
| fym_matches_pick | Use the song you picked |
| Insights, stats and exports | |
| fym_insights_playlist | Followers, sound and health of a playlist |
| fym_stats_section_get | Your listening stats, one section at a time |
| fym_exports_create | Export the songs a transfer left behind |
| fym_premium_plans | The Pro plans; fym_premium_buy opens the checkout |
Sign in with your browser
Ask your assistant to sign you in. It calls fym_sign_in and gives you a short code and a link to freeyourmusic.com/app/cli. Open the link, sign in the way you always do (email, Apple or Google), check the code and tap Allow. The session renews itself while you use it, and the CLI on the same computer shares it.
It asks before it deletes
Every tool tells your AI app what kind of tool it is. Read tools carry the readOnlyHint flag. Tools that delete or replace data, such as deleting a playlist, a merge that removes the originals or disconnecting an account, carry destructiveHint, so your AI app can ask you before it runs them. Deleting your Free Your Music account is not a tool at all: only the CLI can do it.
Free and Pro
In the Free Your Music web app and the mobile apps: connect your services, move playlists, liked songs, albums and artists up to 10,000 songs in total, pick replacements for songs that did not match, use Stats and export the songs that did not move.
The MCP server and the CLI. Keep transfers in sync. Edit, sort, shuffle, dedupe, split, merge and restore playlists. Playlist insights.
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.
Give your assistant the keys to your music.
Copy one command, restart your AI app and ask it to sign you 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.