$ npx -y @freeyourmusic/mcp install --host=claude-code✓ Wrote MCP server config to ~/.claude.json
→ Restart Claude Code, then ask: "Sign me in to Free Your Music."

Free Your Music, inside Claude Code.

Run one command, restart Claude Code, then ask it to sign you in. No desktop app needed.

Four steps to your first answer

Run the command above. It adds a freeyourmusic entry to the Claude Code config file.
Start a new Claude Code session. It loads the freeyourmusic server when it starts.
Ask: "Sign me in to Free Your Music." Open the link it gives you, check that the code matches, sign in and tap Allow.
Ask it to connect a music service, for example "Connect my Spotify account." Sign in to the service in the browser tab that opens.

Then ask Claude Code

Try

"Which of my Spotify playlists are not on Apple Music yet?"

↳ fym_accounts_list↳ fym_library_playlists

Try

"Move my liked songs from Deezer to YouTube Music."

↳ fym_accounts_list↳ fym_transfers_create

Try

"Shuffle my Party playlist on Deezer and spread out the artists. Show me the new order first."

↳ fym_playlists_preview(tool=shuffle)↳ fym_playlists_apply_tool

Try

"Turn on auto-sync for every transfer I have."

↳ fym_transfers_list↳ fym_transfers_set_sync

Where the config lives

~/.claude.json

If something goes wrong

The tools do not show up: Quit Claude Code fully and open it again. If the tools are still missing, run the install command again, or run it with --host=print and paste the JSON into the config file by hand.
The assistant says I am not signed in: Ask it to sign you in. It gives you a link to freeyourmusic.com/app/cli and a short code; approve the code there. If you use the CLI, fym login signs in the MCP server too, because both use the same session on your computer.
Do I need to install a Free Your Music app?: No. The MCP server talks to the Free Your Music API directly. You only need Node.js 20 or newer, so that npx can run it.
How do I remove it?: Delete the freeyourmusic block from ~/.claude.json and restart Claude Code.

Services you can connect

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.

See every MCP tool →Working in a terminal? Get the CLI →