"List my Spotify playlists with track counts."
↳ fym_playlists_list(service=spotify)
$ npx -y @freeyourmusic/mcp install --host=claude-codeWrote freeyourmusic config to {path} Restart {hostName} to pick up the new MCP server.
Free Your Music in Claude Code.
One command. Restart Claude Code. Done.
Install steps
- Run the command above. It writes the freeyourmusic entry into the Claude Code MCP config.
- Confirm the new section was added to ~/.claude.json.
- Reload the project; tools auto-register, no UI restart needed.
What to ask in Claude Code
"Search Apple Music for 'rainy day jazz' and add the top 10 to a new playlist."
↳ fym_search_tracks(service=apple-music)↳ fym_playlists_create↳ fym_tracks_add
"Show my recently liked Tidal tracks."
↳ fym_library_tracks(service=tidal)
"Unfollow YouTube Music artists I haven't played this year."
↳ fym_history_recent(service=youtube-music)↳ fym_unfollow_artist
Where it lives
~/.claude.json
Troubleshooting
- Tools don't appear after install
- Restart Claude Code fully (cmd+Q on macOS for desktop apps). Check that the MCP server status indicator is green.
- Bridge unreachable / open the app
- The FYM desktop app must be running. The MCP server talks to it over 127.0.0.1.
- How do I uninstall
- Remove the freeyourmusic block from ~/.claude.json and restart Claude Code.
Now try one of these
The MCP server connects to Free Your Music through a local bridge on your computer. Tool results go to your AI app; how that app processes them depends on its settings and model provider.
Your AI host→Local bridge (127.0.0.1)→FYM desktop
Plug in your music.
One command for your AI host. Restart. Done.
Install in
npx -y @freeyourmusic/mcp install --host=claude-desktopWrites to ~/Library/Application Support/Claude/claude_desktop_config.json
Restart Claude Desktop (cmd+Q on macOS). The freeyourmusic tools appear in the integrations sheet.