musickit

Search Apple Music and control playback with Now Playing metadata in iOS apps.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill musickit-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: musickit
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/swift-ios-skills/skills/musickit
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill musickit-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you integrate Apple Music catalog search and in-app playback with correct authorization, subscription gating, and reliable Lock Screen metadata.

Core Features & Use Cases

  • Catalog search: Search Apple Music content using MusicKit and present playable results in your UI.
  • Playback & queue management: Play Apple Music items via ApplicationMusicPlayer with queue insertion and control.
  • Now Playing & remote controls: Publish Now Playing metadata through MPNowPlayingInfoCenter and handle Lock Screen / AirPods / CarPlay actions via MPRemoteCommandCenter.

Quick Start

Ask it: "Show me how to request MusicKit authorization, search for songs, play one with ApplicationMusicPlayer, and update Now Playing + remote commands in a SwiftUI iOS 26+ app."

Frequently Asked Questions about musickit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I play Apple Music songs in my iOS app and show them on the Lock Screen?

To play Apple Music songs and show them on the Lock Screen, use ApplicationMusicPlayer for queue-based playback and register MPRemoteCommandCenter with MPNowPlayingInfoCenter to publish Now Playing metadata for iOS controls.

How do I check Apple Music subscription status before playing music in iOS?

Check Apple Music subscription status by using MusicSubscription to gate playback and MusicAuthorization to request user access. This ensures your iOS app correctly verifies subscription-aware playback eligibility before playing content.

How do I search the Apple Music catalog and play results using MusicKit?

Search the Apple Music catalog using MusicKit APIs to retrieve playable content, then play the returned items by inserting them into the ApplicationMusicPlayer queue for immediate playback within your iOS app.

Do I need special entitlements to use ApplicationMusicPlayer in my iOS app?

Yes, using ApplicationMusicPlayer requires MusicKit entitlements and an NSAppleMusicUsageDescription entry in your Info.plist to handle authorization requests and enable Apple Music subscription flows correctly.

How do I handle AirPods and CarPlay remote commands for Apple Music playback?

Handle AirPods and CarPlay remote commands by registering MPRemoteCommandCenter handlers in your iOS app. This connects external playback actions to your ApplicationMusicPlayer queue and updates MPNowPlayingInfoCenter metadata accordingly.

Why is my Now Playing info not updating on the iOS Lock Screen?

Now Playing info fails to update on the iOS Lock Screen if MPNowPlayingInfoCenter properties are not refreshed after queue changes or if MPRemoteCommandCenter handlers are not properly registered to sync with ApplicationMusicPlayer state.