Support

Questions or problems? Most answers are below. If not, write to support@coolplay.io.

Getting started

Open Music MCP. It lives in the menu bar (the plug icon) and has no Dock icon.
Click the icon, choose Set Up Apple Music, and allow access when macOS asks.
Under Connect Your AI, click Copy Setup Prompt and paste it into your AI agent. The agent adds Music MCP to its own settings.
Ask your AI to play something, for example “something calm for a late evening”.

Common questions

Which AI apps work with Music MCP?

Any app that supports MCP servers (Model Context Protocol). Agents that can edit their own settings, such as coding agents, set themselves up from the setup prompt. For other apps, open Manual Setup, pick your app and click Copy Settings. If your app isn't listed, choose Other app (HTTP) or Other app (command).

Download or App Store?

Both are the same app, and both update themselves. The Mac App Store keeps its version up to date. The version you download here is signed and checked by Apple (notarized) too, and looks for a new version once a day: it shows you what's new, and after your click it downloads the update, installs it and starts again. Check for Updates… in the menu looks right away. Use one or the other, not both.

Do I need an Apple Music subscription?

Yes, to play songs. Your AI can search the catalog without one, and the panel shows a note if your account can't play music.

Does it work with the browser or phone version of my AI?

No. Music MCP runs on your Mac and only accepts connections from it, so it works with AI apps that run on the same Mac.

Can my AI see my library?

Only if you allow it. The first time your AI wants your library, Music MCP asks you in a small window. Choose Turn On, and your AI can read your songs, playlists and recently played music to pick music you like. You can also switch Share Library & History on or off under Connect Your AI in the panel.

Can my AI create playlists?

Yes, if you allow it: Music MCP asks the first time, or you turn on Allow Library Changes under Connect Your AI. Then your AI can save a set as a playlist, add songs to your playlists, add music to your library, and love or dislike songs. It can't delete or rename anything. It's off by default.

Does music keep playing when I close my AI app?

Yes. Playback runs in Music MCP, not in your AI app. Quitting Music MCP stops it.

Is what I play saved in my Apple Music history?

Yes. Songs you play through Music MCP are saved in your Apple Music listening history, like songs you play in the Music app. The Recently Played row in the Music app lists albums, playlists and stations: an album your AI plays shows up there, a set of single songs it picked doesn't. To see those, ask your AI what you listened to recently (with Share Library & History on).

Can I play on a HomePod or another AirPlay speaker?

Yes. Music MCP plays on your Mac's sound output, so choose the speaker there: in Control Center under Sound, or with the speaker button in the Music MCP panel, which opens the Mac's sound settings. All of your Mac's sound then goes to that speaker.

Does Music MCP start by itself?

Only when your AI needs it. If Music MCP is closed and your AI asks for music, it starts and its icon appears in the menu bar. Opening your AI app, or a new chat in it, leaves Music MCP closed.

Troubleshooting

My AI says it can't reach Music MCP

Check that Music MCP is running: the plug icon is in the menu bar and the panel says Ready for your AI.
If you used Reset Access Token…, every AI app was disconnected. Paste the setup prompt, or the manual settings, into your AI apps again.
Restart your AI app, or reload its MCP servers, after changing its settings.
Since version 1.4.12 the app's file is named MusicMCP, without the space, because some AI apps can't start a program with a space in its name. If your AI lost Music MCP after that update, or after you moved the app, paste the setup prompt into it once more: it corrects its own settings. Music MCP tells you when that's needed.

Music stutters, for example on a train or over a phone hotspot

If playback in Music MCP is choppy while other apps play fine, check whether Low Data Mode is on for your connection: System Settings → Network → your connection (Wi-Fi, iPhone USB, …) → Details…. With Low Data Mode on, macOS asks apps to save data, so Music MCP buffers very little ahead and every dip in the connection becomes audible. Turn it off for smooth playback.

I can't find the icon in the menu bar

On Macs with a notch, icons that don't fit next to it are hidden. Quit a few other menu bar apps, or hold ⌘ and drag icons to make room. Also check that Music MCP is allowed in System Settings → Menu Bar.

“Set Up Apple Music” doesn't work

If you denied access earlier, macOS doesn't ask again. Click Open System Settings in the panel, or turn it on in System Settings → Privacy & Security → Media & Apple Music.

My AI asks me to turn on sharing

Your AI tried to read your library or history while Share Library & History is off. Turn it on if you're happy to share, or ask for music without it. If you choose Not Now and your AI tries again at once, Music MCP doesn't ask a second time; with your next request it asks again.

Contact

Email support@coolplay.io. Please include your macOS version, the Music MCP version (shown in the App Store) and which AI app you use. We usually reply within one to two business days.