"List my Apple Music playlists with the number of songs in each."
Apple Music, inside your AI assistant.
Connect Apple Music to your Free Your Music account once. Then ask Claude, Cursor, Cline or Claude Code to read your playlists, move them to another service and keep them in sync.
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.
Ask about your Apple Music music
"Make an Apple Music playlist of ten Nina Simone classics."
"Move my whole Apple Music library to YouTube Music."
"Which songs from my last Apple Music transfer did not match?"
What works on {serviceName}
With Pro, the assistant can edit your Apple Music playlists. What it can change depends on Apple Music and on the playlist: nobody can edit a playlist that somebody else made. The assistant reads what each playlist allows before it acts.
Set up Apple Music in three steps
- Install the MCP server in your AI app with the command below, then restart the app.
- Ask your assistant to sign you in to Free Your Music, and approve the code in your browser.
- Ask it to connect Apple Music, and sign in to Apple Music in the browser tab that opens.
Install it in your AI app
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.
More services, same server
See every tool of the Free Your Music MCP server
Free and Pro
In the Free Your Music web app and the mobile apps: connect your services, move playlists, liked songs, albums and artists with no song limit, 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.
Apple Music MCP: common questions
What does the Apple Music MCP server do?
It lets an AI assistant use your Apple Music account through Free Your Music. MCP (Model Context Protocol) is the way apps like Claude and Cursor call outside tools. You ask in plain words, and the assistant picks the Free Your Music tools it needs.
How do I connect Apple Music to Claude?
Run npx -y @freeyourmusic/mcp install --host=claude-desktop (or --host=claude-code) and restart Claude. Ask Claude to sign you in to Free Your Music and approve the code in your browser. Then ask it to connect Apple Music.
Does it work with Cursor and Cline too?
Yes. One server works in Claude Desktop, Claude Code, Cursor and Cline. Install it once per app. They all share one Free Your Music sign-in on your computer, and your Apple Music connection lives in your Free Your Music account, so you connect Apple Music only once.
What can my assistant do with Apple Music?
It can read your Apple Music library and move it to or from any other service you connected. It can start a transfer, follow its progress, turn on auto-sync and list the songs that did not match.
It can search the Apple Music catalogue, for example to find the right version of a song that did not match.
With Pro, it can edit your Apple Music playlists: add and remove songs, sort, shuffle, remove duplicates, split, merge and go back to an earlier version, where Apple Music allows it.
Is the Apple Music MCP server free?
No. The Apple Music MCP server is part of Free Your Music Pro, together with the CLI, auto-sync, the playlist tools and playlist insights. Transfers in the Free Your Music web app and the mobile apps stay free, with no song limit.
Is this an official Apple Music server?
No. Free Your Music builds it independently. It reaches Apple Music through the account you connect to Free Your Music. To use it, install the @freeyourmusic/mcp package shown on this page.
Where does the server run?
On your computer, with Node.js. Your AI app starts it and talks to it over stdio, and it calls the Free Your Music API over HTTPS. You do not paste a server URL.
Can I connect two Apple Music accounts?
Yes. Each connected account has its own id. Tell the assistant which Apple Music account you mean, for example by its name, and it picks the right one from your account list.
Can Claude build an Apple Music playlist for me?
Yes. Claude searches Apple Music, creates the playlist and adds the songs you pick. Check its picks before it saves them. Apple Music does not let apps remove songs from a playlist, so Claude cannot take a song out again.
Setup guides per AI app
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.