Work in Progress These docs are a work in progress. More content is coming soon.

← Back to Documentation

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

  1. Navigate to your MCP server panel in the toolforest.io dashboard.
  2. Locate the Apple Music toolkit.
  3. Click the Connect button.
  4. 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:

  1. Click the Disconnect button in your MCP server panel.
  2. toolforest.io will remove the access tokens used to communicate with Apple Music.
🔒 Note
Disconnecting removes toolforest.io's access tokens but does not automatically revoke permissions in your Apple Account settings.

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

CategoryCapabilities
PermissionsView granted scopes, storefront/region, subscription status
DiscoverySearch catalog (songs, artists, albums, playlists), get charts by region/genre, personalized recommendations, heavy rotation
DetailsSong metadata (duration, release date, genre, ISRC, composer, lyrics availability), artist info with top songs/albums
LibrarySearch/list library songs with sorting, list saved playlists, add songs/albums/playlists to library
PlaylistsCreate playlists with optional initial tracks, add tracks to existing playlists, view playlist contents with pagination
RatingsLike, dislike, or remove ratings on songs, albums, playlists, and music videos to influence recommendations