Summary
Connects Claude directly to Apple's App Store Connect API for managing your iOS and macOS apps. You get tools to list apps, create new App Store versions, update localized metadata, pull sales and analytics data, read customer reviews, and manage TestFlight builds and beta testers. Supports both local usage with direct API keys and remote deployment via OAuth through Auth0. Requires an Apple Developer account and an App Store Connect API key with appropriate permissions. Reach for this when you need to automate app release workflows, monitor sales performance, or handle TestFlight distribution without leaving your Claude conversation.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →🍎 App Store Connect MCP Server
A Model Context Protocol (MCP) server that connects AI assistants like Claude Desktop, Cursor, Windsurf, and VS Code to the Apple App Store Connect API.
Automate TestFlight builds, customer review analysis, app metadata updates, and sales reports directly inside your AI coding workflow.
💡 Quickstart (npx)
No need to clone or build manually! You can run this MCP server directly using npx.
1. Generate App Store Connect API Key
- Log into App Store Connect.
- Navigate to Users and Access ➔ Integrations ➔ App Store Connect API.
- Click Generate API Key (Admin or App Manager role recommended).
- Download the
.p8key file and note your Key ID and Issuer ID.
2. Add to Your MCP Client
🟢 Claude Desktop
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "@ryaker/appstore-connect-mcp"],
"env": {
"APPLE_KEY_ID": "YOUR_KEY_ID",
"APPLE_ISSUER_ID": "YOUR_ISSUER_ID",
"APPLE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
}
}
}
}
⚡ Cursor Add this to ~/.cursor/mcp.json or under Cursor Settings ➔ Features ➔ MCP:
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "@ryaker/appstore-connect-mcp"],
"env": {
"APPLE_KEY_ID": "YOUR_KEY_ID",
"APPLE_ISSUER_ID": "YOUR_ISSUER_ID",
"APPLE_PRIVATE_KEY": "YOUR_PRIVATE_KEY_BASE64_OR_RAW"
}
}
}
}
🏄 Windsurf Add this to ~/.codeium/windsurf/mcp_config.json:
JSON
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "@ryaker/appstore-connect-mcp"],
"env": {
"APPLE_KEY_ID": "YOUR_KEY_ID",
"APPLE_ISSUER_ID": "YOUR_ISSUER_ID",
"APPLE_PRIVATE_KEY": "YOUR_PRIVATE_KEY"
}
}
}
}
🛠️ Features 📱 App Management: View apps, query version statuses, edit localizations & release notes.
✈️ TestFlight Integration: List builds, manage beta testing groups, and add/remove beta testers.
💬 Customer Reviews: Read, summarize, and draft responses to user reviews.
📊 Analytics & Sales: Retrieve unit downloads, revenue metrics, and regional performance.
🔐 Dual Auth Support: Supports direct local API Key authentication or remote OAuth 2.0 (via Auth0).
💬 Example Prompts Once configured, try asking your AI assistant:
"Show me the latest TestFlight builds for my app and their processing status."
"What are the most recent 1-star reviews on the App Store and summarize user complaints?"
"Update the release notes for version 1.2.0 in English (US)."
"Give me a summary of app downloads for the past 14 days."
🔑 Environment Variables
| Variable | Required | Description |
|---|---|---|
APPLE_KEY_ID | Yes | Your App Store Connect API Key ID |
APPLE_ISSUER_ID | Yes | Your App Store Connect Issuer ID |
APPLE_PRIVATE_KEY | Yes | Raw PEM content or Base64-encoded string of your .p8 key |
APPLE_BUNDLE_ID | Optional | Restrict tool scope to a specific app bundle ID |
APPLE_APP_STORE_ID | Optional | Restrict tool scope to a specific App Store ID |
OAUTH_ENABLED | Optional | Set true if deploying as a remote server via OAuth 2.0 |
💻 Local Development If you want to contribute or modify the source code locally:
Bash
# 1. Clone repo
git clone [https://github.com/ryaker/appstore-connect-mcp.git](https://github.com/ryaker/appstore-connect-mcp.git)
cd appstore-connect-mcp
# 2. Install & build
npm install
npm run build
# 3. Test locally
npm start
🤝 Contributing & Support Feel free to open an Issue for bug reports, missing App Store Connect endpoints, or feature requests!
License: MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
APPLE_KEY_ID*secretApple App Store Connect API Key ID
APPLE_ISSUER_ID*secretApple App Store Connect Issuer ID
APPLE_PRIVATE_KEY*secretApple App Store Connect Private Key (base64 encoded or raw)
APPLE_BUNDLE_IDOptional: Specific Bundle ID to filter apps
APPLE_APP_STORE_IDOptional: Specific App Store ID
OAUTH_ENABLEDEnable OAuth authentication (true/false)
OAUTH_ISSUEROAuth issuer URL (e.g., https://your-tenant.auth0.com)
OAUTH_AUDIENCEOAuth audience URL
OAUTH_JWKS_URIOAuth JWKS URI for token validation
SERVER_URLServer URL for OAuth deployment
Categories
Registryactive
Package@ryaker/appstore-connect-mcp
TransportSTDIO
AuthRequired
UpdatedSep 10, 2025
