--- title: appnova-app-store-connect-mcp emoji: 🍎 colorFrom: gray colorTo: red sdk: docker app_port: 7860 pinned: false ---
appnova-app-store-connect-mcp
App Store Connect MCP server for Claude — manage your iOS app's entire lifecycle with natural language. No Docker, no Python, no pip. Just add 4 lines to your Claude config and start talking to your App Store.
48 tools · 14 categories · Hosted on Hugging Face Spaces · Free
---
Quick Start — Zero Setup (Recommended)
No installation required. The server is already running on Hugging Face Spaces.
📖 Full installation guide with screenshots and troubleshooting: docs/installation.md
1. Get your App Store Connect API credentials
Go to App Store Connect → Users and Access → Integrations and create an API key with Admin or App Manager role. You'll need:
- Issuer ID — shown at the top of the API Keys page
- Key ID — shown next to your key
- Private key — download the
.p8file (only downloadable once) - Vendor Number — from Payments and Financial Reports
2. Add to your Claude client
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"appstore": {
"url": "https://haikuku-appnova-app-store-connect-mcp.hf.space/mcp",
"headers": {
"x-appstore-issuer-id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"x-appstore-key-id": "XXXXXXXXXX",
"x-appstore-private-key": "-----BEGIN PRIVATE KEY-----\\nMIGH...\\n-----END PRIVATE KEY-----",
"x-appstore-vendor-number": "12345678"
}
}
}
}Claude Code
Add to .mcp.json in your project root:
{
"mcpServers": {
"appstore": {
"type": "http",
"url": "https://haikuku-appnova-app-store-connect-mcp.hf.space/mcp",
"headers": {
"x-appstore-issuer-id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"x-appstore-key-id": "XXXXXXXXXX",
"x-appstore-private-key": "-----BEGIN PRIVATE KEY-----\\nMIGH...\\n-----END PRIVATE KEY-----",
"x-appstore-vendor-number": "12345678"
}
}
}
}3. Restart your Claude client
That's it. Ask Claude: "List my apps" to verify the connection.
---
How to format the private key
Open your .p8 file — it looks like this:
-----BEGIN PRIVATE KEY-----
MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQg...
-----END PRIVATE KEY-----Important: In the JSON config you must use \\n (two characters: backslash + n) instead of real line breaks. Using a single \n creates an actual newline which breaks HTTP headers.
Use this one-liner to get the correctly formatted value:
awk '{printf "%s\\n", $0}' AuthKey_XXXXXXXXXX.p8 | sed '$ s/\\n$//'Paste the output directly as the x-appstore-private-key value.
---
Optional: Pin a default app
Add x-appstore-app-id to skip calling select_app every session:
"headers": {
"x-appstore-issuer-id": "...",
"x-appstore-key-id": "...",
"x-appstore-private-key": "...",
"x-appstore-vendor-number": "...",
"x-appstore-app-id": "6502225088"
}Use either the numeric App Store ID or bundle ID (e.g. com.example.yourapp).
---
Security
Your credentials are sent as HTTP headers directly to the server and used exclusively to sign JWT tokens for Apple's API. They are not logged, not stored, and not shared. Each request is fully isolated — credentials from one user never touch another user's session.
The server is open source: github.com/alperduzgun/appnova-app-store-connect-mcp
If you prefer to host it yourself, see the Self-Hosting section below.
---
What You Can Do
App Store Optimization (ASO)
| Tool | Description | |------|-------------| | get_locales | List all localizations with IDs — lightweight index, call first | | get_locale_metadata | Full metadata for one locale: name, subtitle, keywords, description, what's new | | update_info | Update app name and/or subtitle (always editable, any version state) | | update_version | Update keywords, description, what's new (requires PREPARE_FOR_SUBMISSION) | | list_custom_product_pages | List all Custom Product Pages with version state and visibility | | get_custom_product_page | Full CPP detail including per-locale promotional text |
Reviews & Ratings
| Tool | Description | |------|-------------| | get_reviews | Fetch reviews sorted by newest; filter by star rating (1–5) | | get_ratings | Average rating, total count, sample size | | respond_to_review | Post a new developer response | | update_review_response | Edit an existing response in-place (preserves timestamp) | | delete_review_response | Delete a response before re-posting |
Analytics & Sales
| Tool | Description | |------|-------------| | get_analytics | Impressions, page views, app units, conversion rate, sessions, crashes — daily breakdown up to 365 days | | get_sales | Downloads, redownloads, updates, IAP, subscriptions, revenue — daily breakdown up to 365 days |
Finance Reports
| Tool | Description | |------|-------------| | get_finance_report | Monthly proceeds by territory and currency for a specific month | | get_finance_summary | Aggregated proceeds across the last N months (default 3, max 12) |
Subscriptions
| Tool | Description | |------|-------------| | list_subscription_groups | All subscription groups and their products | | create_subscription_group | Create a new subscription group | | create_subscription | Create a subscription product (weekly → yearly) | | create_subscription_localization | Add localized name and description to a subscription |
In-App Purchases
| Tool | Description | |------|-------------| | list_in_app_purchases | All IAPs: consumable, non-consumable, non-renewing | | create_in_app_purchase | Create a new IAP product | | create_iap_localization | Add localized display name and description | | delete_in_app_purchase | Delete a draft IAP |
Pricing
| Tool | Description | |------|-------------| | get_iap_price_points | All available price tiers for an IAP in a territory | | set_iap_price | Set IAP price by price point ID | | set_iap_price_by_amount | Set IAP price by dollar amount — auto-matches tier | | get_subscription_price_points | All available price tiers for a subscription | | set_subscription_price | Set subscription price by price point ID | | set_subscription_price_by_amount | Set subscription price by dollar amount — auto-matches tier |
App Versions & Submission
| Tool | Description | |------|-------------| | list_app_versions | Recent versions with state (READY_FOR_SALE, IN_REVIEW, etc.) | | create_app_version | Create a new version in PREPARE_FOR_SUBMISSION state | | submit_for_review | Submit a version for App Review | | cancel_submission | Withdraw an in-progress submission |
Phased Release
| Tool | Description | |------|-------------| | get_phased_release | Current phased rollout status for a version | | create_phased_release | Enable 7-day phased rollout (1%→2%→5%→10%→20%→50%→100%) | | update_phased_release | Pause, resume, or complete rollout immediately |
TestFlight
| Tool | Description | |------|-------------| | list_builds | Recent builds with processingState, version, expiration | | list_beta_groups | All beta groups with public link info | | add_beta_tester | Invite a tester to a beta group | | remove_beta_tester | Remove a tester from a beta group |
In-App Events
| Tool | Description | |------|-------------| | list_app_events | All promotional events with state (DRAFT/LIVE/ARCHIVED) and localizations |
Bundle ID Capabilities
| Tool | Description | |------|-------------| | get_bundle_id_info | Numeric ID, platform, name, and seed ID for a bundle identifier | | list_bundle_id_capabilities | All active capabilities (Sign in with Apple, Push, IAP, etc.) | | enable_bundle_id_capability | Enable a capability — idempotent, safe to call repeatedly | | disable_bundle_id_capability | Remove a capability by resource ID |
App Selection
| Tool | Description | |------|-------------| | list_apps | All apps in your account | | select_app | Set the active app by numeric ID or bundle ID | | get_active_app | Show the currently selected app |
---
Example Workflows
ASO audit across all locales: `` "Get all my app's locale metadata and tell me which ones are missing keywords or have subtitles under 20 characters" ``
Review triage: `` "Show me all 1-star reviews from the last 50 and draft a response for each one that mentions a crash" ``
Revenue summary: `` "Give me a finance summary for the last 3 months and compare monthly trends" ``
Release workflow: `` "Create a new 2.5.0 version, update the what's new text for en-US and tr, then submit for review" ``
Capability check: `` "List all active capabilities for com.example.myapp and confirm Sign in with Apple is enabled" ``
---
Requirements
- App Store Connect API key with Admin or App Manager role
- Claude Desktop 0.10+ (or any MCP client that supports HTTP transport with custom headers)
---
Self-Hosting
Want to run the server yourself? Full source code and setup instructions at github.com/alperduzgun/appnova-app-store-connect-mcp.
---
License
MIT
