apple-services
Skill0 starsChanged 30 days agoMITView on GitHub
Map of the Apple plugin — which MCP tool family to use for App Store Connect, TestFlight, App Store Server (in-app purchases), Apple Music, WeatherKit, Apple Maps, CloudKit, push notifications (APNs), Sign in with Apple, Apple Business/School Manager, Search Ads, Apple News, iCloud calendar/contacts/mail, public iTunes/App Store data and Apple developer documentation. Load when a task touches any Apple service or API.
In this repository15 other files it gives its agents.
- apnsSkill
- apple-business-managerSkill
- apple-mapsSkill
- apple-musicSkill
- apple-newsSkill
- apple-search-adsSkill
- app-store-connectSkill
- app-store-serverSkill
- cloudkitSkill
- docsSkill
- icloudSkill
- setupSkill
- sign-in-with-appleSkill
- statusSkill
- weatherkitSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 35
Every authenticated family has a generic *_request tool for endpoints without a dedicated tool.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Apple services (plugin apple-services)
The apple MCP server (Rust) exposes ~100 tools. Public tools need no credentials; the
others read ~/.config/apple-mcp/config.json (one section per service). When unsure what
is configured, call apple_status first. To add or fix credentials use apple_configure
(writes one section safely, saves a pasted .p8, verifies the service) and
apple_test_service (read-only probe of every configured service with Apple's exact error);
apple_config_template documents every key and where to get it; /apple-services:setup guides the user.
Pick the tool family
| Need | Tools | Credentials section |
| App Store search, app metadata, charts, Apple outages, developer docs, Apple news | itunes_search, itunes_lookup, apple_charts, apple_system_status, apple_docs, apple_docs_index, apple_technologies, apple_news | none |
| Apps, builds, TestFlight, App Store versions, reviews, signing assets, users, sales/finance reports, Xcode Cloud, notarization | asc_*, notary_* | app_store_connect |
| In-app purchase transactions, subscription status, refunds, server notifications | storekit_*, apple_jws_decode | app_store_server |
| Apple Music catalog/charts/library/playlists | music_* | music |
| Weather forecasts/alerts | weather, weather_* | weatherkit |
| Geocoding, place search, ETAs, directions | maps_* | maps |
| CloudKit public database records | cloudkit_* | cloudkit |
| Send a push notification | apns_send | apns |
| Sign in with Apple secrets/tokens | siwa_* | sign_in_with_apple |
| Device enrollment / MDM assignment (ABM, ASM) | abm_* | business_manager |
| Search Ads campaigns & reports | searchads_* | search_ads |
| Apple News Publisher channel/articles | news_* | news |
| iCloud Calendar, Contacts, Mail | icloud_calendars, icloud_events, icloud_event_*, icloud_contacts, icloud_contact_*, icloud_mail_* | icloud (app-specific password) |
| iCloud Reminders, Notes, Drive, Photos, Find My, Hide My Email | icloud_login, icloud_2fa, icloud_reminders*, icloud_notes*, icloud_drive_*, icloud_photos_*, icloud_findmy_*, icloud_hme_* (see the icloud skill) | icloud.password (Apple ID password, 2FA once) |
Every authenticated family has a generic *_request tool for endpoints without a dedicated
tool; find endpoints with apple_docs_index (technologies: appstoreconnectapi,
appstoreserverapi, applemusicapi, weatherkitrestapi, applemapsserverapi,
cloudkitwebservices, usernotifications, signinwithapplerestapi, applebusinessmanagerapi,
apple_search_ads, applenewsapi).
Conventions
- Responses are JSON trimmed to ~50k characters. If truncated, narrow with
limit,fields, filters, orcompact. JSON:APIlinksare stripped by default (compact: true). - Errors come back as tool errors with the HTTP status, Apple's message and a hint (401 → key/permissions; 403 → role or agreement; 429 → rate limit).
- Tokens are cached in memory (ASC 15 min, Music 11 h, WeatherKit 50 min, Maps 25 min, APNs 45 min,
OAuth per
expires_in). After editing the config file callapple_reload_config. - Destructive tools (delete tester, delete event/contact, move mail, CloudKit modify, revoke) are
annotated
destructiveHint; confirm with the user before running them on real data. - Dates: tools accept RFC 3339 or
YYYY-MM-DD; StoreKit millisecond timestamps get*_isotwins.
Deeper references (load the matching skill)
app-store-connect, app-store-server, apple-music, weatherkit, apple-maps, cloudkit,
apns, sign-in-with-apple, apple-business-manager, apple-search-ads, apple-news, icloud.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.