appstore-connect-mcp — Claude Code MCP server for App Store Connect
Wires your AI assistant into the App Store Connect API: TestFlight builds, reviews, metadata and sales numbers without leaving the editor.
claude mcp add --env APPLE_KEY_ID=<APPLE_KEY_ID> --env APPLE_ISSUER_ID=<APPLE_ISSUER_ID> --env APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> --env APPLE_BUNDLE_ID=<APPLE_BUNDLE_ID> --env APPLE_APP_STORE_ID=<APPLE_APP_STORE_ID> --transport stdio appstore-connect-mcp -- npx -y @ryaker/appstore-connect-mcpWhat appstore-connect-mcp does
The server runs through npx, so there is nothing to clone or compile. Its tools cover the App Store Connect API: list apps and version states, edit localizations and release notes, pull TestFlight builds, manage beta groups and testers, read customer reviews and draft replies, fetch download and revenue metrics by region.
Two auth paths exist. The local one signs requests with an API key, so you need APPLE_KEY_ID, APPLE_ISSUER_ID and APPLE_PRIVATE_KEY holding the contents of your .p8 file. Generate that key in App Store Connect under Users and Access → Integrations → App Store Connect API, with an Admin or App Manager role. No .p8 key, no server — the signature depends on it.
The optional APPLE_BUNDLE_ID and APPLE_APP_STORE_ID narrow every tool to a single app. Set OAUTH_ENABLED when you host the server remotely and authenticate through OAuth 2.0.
What it helps with
- check processing status of the newest TestFlight builds
- pull complaints out of recent one-star reviews
- fix release notes for one specific locale
- add a tester to a beta group
- export download and revenue trends by region
Example prompts for the agent
- List my latest TestFlight builds and where each one sits in processing
- Gather the recent one-star reviews and summarize what users complain about
- Rewrite the release notes for version 1.2.0 in English (US)
How to install appstore-connect-mcp
Platform CLI
claude mcp add --env APPLE_KEY_ID=<APPLE_KEY_ID> --env APPLE_ISSUER_ID=<APPLE_ISSUER_ID> --env APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> --env APPLE_BUNDLE_ID=<APPLE_BUNDLE_ID> --env APPLE_APP_STORE_ID=<APPLE_APP_STORE_ID> --transport stdio appstore-connect-mcp -- npx -y @ryaker/appstore-connect-mcpReplace <…> with your own values. 5 more environment variables are in the server README
Platform CLI
codex mcp add appstore-connect-mcp --env APPLE_KEY_ID=<APPLE_KEY_ID> --env APPLE_ISSUER_ID=<APPLE_ISSUER_ID> --env APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> --env APPLE_BUNDLE_ID=<APPLE_BUNDLE_ID> --env APPLE_APP_STORE_ID=<APPLE_APP_STORE_ID> -- npx -y @ryaker/appstore-connect-mcpReplace <…> with your own values. 5 more environment variables are in the server README
Config file
{
"mcpServers": {
"appstore-connect-mcp": {
"command": "npx",
"args": [
"-y",
"@ryaker/appstore-connect-mcp"
],
"env": {
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_ISSUER_ID": "<APPLE_ISSUER_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_BUNDLE_ID": "<APPLE_BUNDLE_ID>",
"APPLE_APP_STORE_ID": "<APPLE_APP_STORE_ID>"
}
}
}
}Replace <…> with your own values. 5 more environment variables are in the server README
Config file
{
"servers": {
"appstore-connect-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ryaker/appstore-connect-mcp"
],
"env": {
"APPLE_KEY_ID": "<APPLE_KEY_ID>",
"APPLE_ISSUER_ID": "<APPLE_ISSUER_ID>",
"APPLE_PRIVATE_KEY": "<APPLE_PRIVATE_KEY>",
"APPLE_BUNDLE_ID": "<APPLE_BUNDLE_ID>",
"APPLE_APP_STORE_ID": "<APPLE_APP_STORE_ID>"
}
}
}
}Replace <…> with your own values. 5 more environment variables are in the server README
Platform CLI
gemini mcp add -e APPLE_KEY_ID=<APPLE_KEY_ID> -e APPLE_ISSUER_ID=<APPLE_ISSUER_ID> -e APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> -e APPLE_BUNDLE_ID=<APPLE_BUNDLE_ID> -e APPLE_APP_STORE_ID=<APPLE_APP_STORE_ID> appstore-connect-mcp npx -y @ryaker/appstore-connect-mcpReplace <…> with your own values. 5 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about appstore-connect-mcp
How do I install appstore-connect-mcp in Claude Code?
Run `claude mcp add appstore-connect-mcp -e APPLE_KEY_ID=<APPLE_KEY_ID> -e APPLE_ISSUER_ID=<APPLE_ISSUER_ID> -e APPLE_PRIVATE_KEY=<APPLE_PRIVATE_KEY> -- npx -y @ryaker/appstore-connect-mcp`, replacing the placeholders with your own values.
What does appstore-connect-mcp do?
It exposes App Store Connect API tools to your assistant: apps, versions, localizations, TestFlight builds, beta groups, reviews, and download and revenue metrics.
What do I need before running it?
An App Store Connect API key: APPLE_KEY_ID, APPLE_ISSUER_ID, and the .p8 contents in APPLE_PRIVATE_KEY. A remote OAuth 2.0 mode also exists, switched on with OAUTH_ENABLED.
