Apple Music
Get listening data, discover new music, and create custom playlists with AI assistance.
Setup
Connect the Apple Music toolkit to your Apple Account to allow your AI assistant to access your Apple Music listening history, library, and playlists.
Prerequisites
Before connecting your Apple Music account, ensure you have:
- Configured an MCP server in your toolforest.io dashboard.
- An active Apple Music subscription on the Apple Account you’ll authorize.
Setup Steps
Step 1: Connect to Apple Music
- Navigate to your MCP server panel in the toolforest.io dashboard.
- Locate the Apple Music toolkit.
- Click the Connect button.
- You will be automatically redirected to Apple’s authorization page (
authorize.music.apple.com).
Step 2: Sign in to Apple (if needed)
If you’re not already signed in to your Apple Account in the browser, Apple will first prompt you to sign in. Enter your Apple Account email and password, and complete two-factor authentication if prompted. Once signed in, you’ll be taken to the Access Request dialog.
Step 3: Authorize Access
You will see an Apple Access Request dialog stating that app.toolforest.io would like to access your Apple Music, media library, and listening activity.
Click Allow to grant access. If you’d like to authorize with a different Apple Account, use the Use a different Apple Account link before clicking Allow.
Step 4: Confirmation
After authorizing, you will be redirected back to toolforest.io with a “Successful connection” message. The toolkit status will now show Connected, and you can begin querying your data immediately.
Understanding Permissions
What toolforest.io Can Access
toolforest.io requests access to your Apple Music account to enable features such as:
- Listening Activity: Recently played songs, heavy rotation, and personalized recommendations.
- Library: Saved songs, albums, and playlists.
- Playlists: Read existing playlists and create or update playlists you own.
- Catalog: Search the Apple Music catalog for songs, artists, albums, and playlists.
Data Privacy
Your Apple Music data is retrieved only when you explicitly ask your LLM to query it. toolforest.io does not store your historical listening data permanently; it acts as a bridge to fetch the specific information your assistant needs to answer your questions.
Managing Your Connection
Disconnect
To disconnect the toolkit:
- Click the Disconnect button in your MCP server panel.
- toolforest.io will remove the access tokens used to communicate with Apple Music.
Revoke Permissions
To fully revoke toolforest.io’s access to your Apple Music account:
- Visit your Apple Account settings.
- Navigate to Sign in with Apple or Apps Using Apple Account.
- Find toolforest.io in the list of authorized applications and revoke access.
Capabilities
| Category | Capabilities |
|---|---|
| Permissions | View granted scopes, storefront/region, subscription status |
| Discovery | Search catalog (songs, artists, albums, playlists), get charts by region/genre, personalized recommendations, heavy rotation |
| Details | Song metadata (duration, release date, genre, ISRC, composer, lyrics availability), artist info with top songs/albums |
| Library | Search/list library songs with sorting, list saved playlists, add songs/albums/playlists to library |
| Playlists | Create playlists with optional initial tracks, add tracks to existing playlists, view playlist contents with pagination |
| Ratings | Like, dislike, or remove ratings on songs, albums, playlists, and music videos to influence recommendations |