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

1. Apple Developer Account with App Store Connect access
2. 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 .p8 private key file (you can only download it once!)
   • Note your Issuer ID and Key ID

Required Environment Variables

Variable	Description	Required
APP_STORE_ISSUER_ID	Your Issuer ID from App Store Connect (found in Users and Access > Integrations)	Yes
APP_STORE_KEY_ID	The Key ID of your API key	Yes
APP_STORE_PRIVATE_KEY	Contents of your .p8 file with newlines as \n	One of these
APP_STORE_PRIVATE_KEY_PATH	Absolute path to your .p8 private key file	One of these

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)

Tool	Description
list_apps	List all apps in your account
get_app	Get detailed app information
get_app_versions	List app versions

TestFlight (6 tools)

Tool	Description
list_builds	List TestFlight builds
get_build	Get build details
list_beta_testers	List beta testers
add_beta_tester	Add tester to beta group
remove_beta_tester	Remove a beta tester
list_beta_groups	List beta groups

Reviews (4 tools)

Tool	Description
list_reviews	Get customer reviews
get_review	Get specific review
respond_to_review	Reply to a review
delete_review_response	Delete a response

Analytics (5 tools)

Tool	Description
list_analytics_report_requests	List analytics requests
create_analytics_report_request	Create analytics request
list_analytics_reports	List available reports
get_sales_reports_info	Sales report info
get_finance_reports_info	Finance report info

Versions (5 tools)

Tool	Description
create_app_version	Create new version
update_app_version	Update version metadata
submit_for_review	Submit for App Store review
get_app_store_state	Check review status
get_version_localization	Get localization info

Subscriptions & IAP (6 tools)

Tool	Description
list_subscription_groups	List subscription groups
list_subscriptions	List subscriptions
get_subscription	Get subscription details
list_in_app_purchases	List IAPs
get_in_app_purchase	Get IAP details
get_subscription_prices	Get pricing info

Metadata (6 tools)

Tool	Description
update_version_localization	Update description, keywords, what's new, promotional text, URLs
create_version_localization	Create localization for a new language
get_app_info	Get app info ID for app-level localizations
list_app_info_localizations	List localizations (name, subtitle, privacy policy)
update_app_info_localization	Update app name, subtitle, privacy policy
create_app_info_localization	Create app info localization for new language

Build Management (9 tools)

Tool	Description
update_build	Update build attributes (export compliance)
set_build_for_version	Associate a build with an App Store version
submit_build_for_beta_review	Submit build for TestFlight beta review
get_beta_review_status	Get beta app review submission status
list_beta_build_localizations	List "What to Test" notes
update_beta_build_localization	Update "What to Test" notes
create_beta_build_localization	Create "What to Test" for new locale
add_build_to_beta_group	Add build to TestFlight group
remove_build_from_beta_group	Remove build from beta group

App Review & Submission (9 tools)

Tool	Description
get_app_store_review_detail	Get review details (contact, demo account, notes)
update_app_store_review_detail	Update review details for submission
create_app_store_review_detail	Create review details for a version
get_age_rating_declaration	Get age rating settings
update_age_rating_declaration	Update age rating content declarations
get_phased_release	Get phased release status
create_phased_release	Create phased release (gradual rollout)
update_phased_release	Pause, resume, or complete phased release
delete_phased_release	Delete phased release configuration

Pricing & Categories (8 tools)

Tool	Description
list_app_categories	List available App Store categories
update_app_categories	Update app's primary/secondary categories
list_territories	List all territories with currency codes
list_app_price_points	List price points for an app in a territory
get_app_price_schedule	Get current price schedule
set_app_price_schedule	Set app pricing
get_app_availability	Get territories where app is available
set_app_availability	Set app availability by territory

Resources

The server also exposes MCP resources:

• appstore://apps - List of all apps
• appstore://apps/{appId} - Specific app details
• appstore://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 .p8 file 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)