MCP App Store Connect
An MCP (Model Context Protocol) server for Apple's App Store Connect API. This server enables AI assistants to manage iOS/macOS apps, TestFlight, analytics, reviews, subscriptions, and more.
54 tools available for comprehensive App Store Connect automation.
Features
- App Management: List apps, get app details, view app versions
- TestFlight: Manage builds, beta testers, and beta groups
- Customer Reviews: List reviews, respond to reviews
- Analytics: Access sales reports, finance reports, and analytics data
- Version Management: Create versions, update metadata, submit for review
- Subscriptions & IAP: Manage subscription groups, in-app purchases, and pricing
- Metadata Management: Update app descriptions, keywords, what's new, app name, subtitle, privacy policy
- Build Management: Set builds for versions, submit for beta review, manage beta localizations
- App Review: Configure review details, age ratings, and phased releases
- Pricing & Availability: Set app pricing, categories, and territory availability
Prerequisites
- Apple Developer Account with App Store Connect access
- API Key from App Store Connect:
- Go to App Store Connect
- Navigate to Users and Access > Integrations > App Store Connect API
- Click Generate API Key (requires Admin role)
- Select Admin or App Manager access
- Download the
.p8private key file (you can only download it once!) - Note your Issuer ID and Key ID
Required Environment Variables
Installation & Setup
Claude Code
Add to your Claude Code MCP settings:
Via CLI:
claude mcp add-json appstore-connect '{
"command": "npx",
"args": ["-y", "mcp-appstore-connect"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
}
}'
Or manually edit ~/.claude/settings.json:
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "mcp-appstore-connect"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
}
}
}
}
Cursor
Add to your Cursor MCP settings (~/.cursor/mcp.json):
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "mcp-appstore-connect"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
}
}
}
}
Windsurf
Add to your Windsurf MCP configuration (~/.windsurf/mcp.json):
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "mcp-appstore-connect"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
}
}
}
}
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "mcp-appstore-connect"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
}
}
}
}
Using Private Key Content Instead of Path
If you prefer to use the key content directly (useful for CI/CD or environments without file access):
{
"mcpServers": {
"appstore-connect": {
"command": "npx",
"args": ["-y", "mcp-appstore-connect"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nMIGT...your-key-content...\n-----END PRIVATE KEY-----"
}
}
}
}
Install from Source
git clone https://github.com/ahmetsina/mcp-appstore-connect.git
cd mcp-appstore-connect
npm install
npm run build
Then use the local path in your MCP config:
{
"mcpServers": {
"appstore-connect": {
"command": "node",
"args": ["/path/to/mcp-appstore-connect/dist/index.js"],
"env": {
"APP_STORE_ISSUER_ID": "your-issuer-id",
"APP_STORE_KEY_ID": "your-key-id",
"APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
}
}
}
}
Available Tools
Apps (3 tools)
TestFlight (6 tools)
Reviews (4 tools)
Analytics (5 tools)
Versions (5 tools)
Subscriptions & IAP (6 tools)
Metadata (6 tools)
Build Management (9 tools)
App Review & Submission (9 tools)
Pricing & Categories (8 tools)
Resources
The server also exposes MCP resources:
appstore://apps- List of all appsappstore://apps/{appId}- Specific app detailsappstore://apps/{appId}/reviews- App reviews
Rate Limits
The App Store Connect API has rate limits:
- ~3,600 requests per hour
- ~300 requests per minute
The server automatically handles rate limiting with:
- Rate limit header parsing
- Exponential backoff on 429 errors
- Warning logs when approaching limits
Error Handling
The server provides detailed error messages for:
- Authentication failures (invalid credentials)
- Rate limit exceeded
- Invalid requests (400 errors)
- Server errors (5xx with retry)
Development
# Run in development mode
npm run dev
# Type check
npm run typecheck
# Run tests
npm test
# Lint
npm run lint
# Build for production
npm run build
Troubleshooting
"Missing APP_STORE_ISSUER_ID" Error
Make sure all required environment variables are set in your MCP configuration. The path to your .p8 file must be an absolute path.
"Authentication failed" Error
- Verify your Issuer ID and Key ID are correct
- Ensure your API key has the required permissions (Admin or App Manager)
- Check that your
.p8file is valid and hasn't been modified
"Rate limit exceeded" Error
The server will automatically retry with exponential backoff. If you consistently hit rate limits, reduce the frequency of your requests.
License
MIT
Author
Ahmet Sina Ustem (@ahmetsina)