$ fym library playlistsNAME          SERVICE        SONGS
Road Trip     spotify          112
Deep Focus    apple-music       64
Late Night    tidal             38

Your music, scriptable.

fym puts the Free Your Music web app in your terminal. Move playlists between 12 services, run playlist tools, watch transfers and export reports. Part of Free Your Music Pro. No desktop app: Node.js 20 or newer is enough.

npm i -g @freeyourmusic/cli
12 music servicesOne account connects them all
No desktop appNode.js 20 is all you install
One browser sign-inEmail, Apple or Google, approved with a code

Start in four commands

npm i -g @freeyourmusic/cli
fym login
fym services connect spotify
fym library playlists

fym login opens freeyourmusic.com/app/cli with a short code. Sign in with email, Apple or Google, check the code and tap Allow. On a server with no browser, add --no-browser and open the link on your phone.

Commands you will use most

There is one command for each operation of the Free Your Music web API. Run fym help to list them all, and add --help to any command to see its flags.

LIBRARY & SEARCH

fym statusfym accounts listfym library playlists --account-id <id>fym library tracks --account-uuid <id> --entity-type playlists --collection-raw-id <playlist>fym search --account-id <id> --q "phoebe bridgers"fym playlists create --account-id <id> --name "Road Trip"fym stats section get --section <section> --range <range> --account-id <id>

TRANSFERS & SYNC

fym transfers create --input @transfer.jsonfym transfers listfym transfers progressfym transfers set-sync --transfer-uuid <id> --enabled truefym matches unmatchedfym exports create --input @export.jsonfym watch

PLAYLIST TOOLS

fym playlists preview --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists apply-tool --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists edits --account-id <id> --playlist-id <playlist> --ops @ops.jsonfym playlists merge --input @merge.json --yesfym playlists versions --account-id <id> --playlist-id <playlist>fym playlists restore --account-id <id> --playlist-id <playlist> ...fym insights playlist --account-id <id> --playlist-id <playlist>

Built for scripts

Add --json to any command and pipe the answer into jq, a script or an agent. The exit code tells your script what happened: 2 means sign in again, 4 means the command needs Pro, 5 means slow down.

fym library playlists --json | jq -r '.items[] | "\(.trackCount)\t\(.name)"'

Safe in cron and CI

Set FYM_TOKEN to an account token and the CLI never opens a browser. Commands that delete or replace data, such as playlists delete or a merge, stop unless you add --yes, so a script cannot delete by accident.

CLI or MCP server?

Best forCLI: scripts, cron jobs and CI. MCP: a chat with Claude, Cursor or Cline.
Sign-inThe same browser approval. Both share one session on your computer.
OutputCLI: tables, or JSON with --json. MCP: structured tool results.
FeaturesThe same: everything the Free Your Music web app can do.

Same account, same rules. Pick the one that fits the job, or use both.

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 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.

Pro

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.

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-desktop

Writes 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.