On this page5 sections ▾
The Free Your Music MCP server lets an AI assistant use your Free Your Music account. You ask in a chat, for example "move my road trip playlist to Apple Music and keep it in sync", and the assistant calls Free Your Music tools to do it. It can do everything the Free Your Music web app can do. The MCP server is part of Pro.
What you need
- An MCP host: Claude Desktop, Claude Code, Cursor or Cline.
- Node.js 20 or newer, so that the host can run the server with npx.
- A Free Your Music account with Pro: the same account you use at freeyourmusic.com/app.
Install it
Install the Free Your Music MCP server
- In a terminal, run the command for your host. Claude Desktop: npx -y @freeyourmusic/mcp install --host=claude-desktop. Claude Code: --host=claude-code. Cursor: --host=cursor. Cline: --host=cline.
- Restart the host. The tools appear under the freeyourmusic server.
- Ask the assistant: "Sign me in to Free Your Music." It gives you a link to freeyourmusic.com/app/cli and a short code.
- Open the link, sign in with email, Apple or Google, check that the code matches and tap Allow. Without Pro, the page offers Pro first.
- Ask it to connect a music service, for example "Connect my Spotify account", and sign in to that service in the browser.
Each host has its own install page with the exact config file and restart step: Claude Desktop, Claude Code, Cursor, Cline. For another host, run npx -y @freeyourmusic/mcp install --host=print and paste the JSON it prints into the host config.
What can the assistant do?
| Tools | What they do |
|---|---|
| Account | Sign in, show your Pro state, connect and list music services |
| Library and search | Read playlists, liked songs, albums and artists; search a service |
| Transfers | Start, follow, pause, resume and delete transfers; Keep in sync |
| Playlist tools | Create a playlist; edit songs, sort, shuffle, remove duplicates, split, merge, copy, restore a version |
| Matches | Review songs that did not match and pick a replacement |
| Insights, stats and exports | Playlist insights, listening stats, exports |
Tools that delete or replace data, such as deleting a playlist, carry a warning flag, so your host can ask you before it runs them. Deleting your Free Your Music account is not a tool: only the CLI can do that.
Privacy
- The MCP server runs on your computer and calls the Free Your Music API over HTTPS, as the web app does.
- Your session sits in ~/.fym/credentials.json, a file only your user account can read. The CLI on the same computer shares it.
- Your music service logins stay on Free Your Music servers. The assistant never sees your passwords.
- The MCP server adds no tracking. Published versions report unexpected errors to our crash-reporting tool, without your tool arguments or credentials. Set FYM_DISABLE_TELEMETRY=1 to turn that off.
- Tool results go to your AI app. How that app processes them depends on its settings and its model provider.
Frequently asked questions
The tools do not show up in my host. What do I do?
Restart the host fully after the install. If the tools still do not show, run the install command again, or use --host=print and add the JSON to the host config by hand.
Does the MCP server work on my phone?
No. It runs on a computer with Node.js, next to an MCP host such as Claude Desktop or Cursor. On your phone, use the Free Your Music app.
Does my AI assistant see my music service passwords?
No. Your music service logins stay on Free Your Music servers. The assistant only gets the results of the tools it calls.
Read more about Free Your Music and AI tools. Still stuck? Contact support and tell us which host you use.