Apple Store Connect MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Apple Store Connect API, enabling management of iOS/macOS apps, TestFlight, app metadata, and more through Claude Desktop or other MCP clients.

Features

App Management

• List Apps: View all apps in your App Store Connect account

• App Information: Get detailed app info including status and metadata

• App Store Versions: Create and manage app store versions

• Localization: Update app descriptions and metadata for different markets

Analytics & Sales

• Sales Data: Retrieve sales and revenue information

• Analytics: Access app analytics including installs and user engagement

• Customer Reviews: Read and analyze customer feedback

• Pricing Information: View current app pricing across different regions

TestFlight Integration

• Build Management: View TestFlight builds and their status

• Beta Groups: Manage TestFlight beta testing groups

• Tester Management: Add and manage beta testers

Additional Features

• In-App Purchases: View and manage in-app purchase products

• App Availability: Check app availability across different regions

• Category & Rating: Access app category and age rating information

Related MCP server: App Store Connect MCP Server

Setup

Prerequisites

• Node.js 18+

• Apple Developer Account with App Store Connect access

• App Store Connect API key

Apple Store Connect API Key Setup

1. Generate API Key:

   • Go to App Store Connect

   • Navigate to Users and Access → Integrations → App Store Connect API

   • Create a new API key with appropriate permissions

2. Environment Variables:

   APPLE_KEY_ID=your_key_id
   APPLE_ISSUER_ID=your_issuer_id  
   APPLE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----
   your_private_key_content
   -----END PRIVATE KEY-----"
   APPLE_BUNDLE_ID=com.yourcompany.yourapp

Installation

# Clone the repository
git clone https://github.com/ryaker/appstore-connect-mcp.git
cd appstore-connect-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the server
npm start

Claude Desktop Configuration

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "appstore-connect": {
      "command": "node",
      "args": ["/path/to/appstore-connect-mcp/dist/src/index.js"],
      "env": {
        "APPLE_KEY_ID": "your_key_id",
        "APPLE_ISSUER_ID": "your_issuer_id",
        "APPLE_PRIVATE_KEY": "your_private_key",
        "APPLE_BUNDLE_ID": "com.yourcompany.yourapp"
      }
    }
  }
}

Usage

Once configured, you can ask Claude to:

• "Show me my app's latest sales data"

• "List all TestFlight builds for my app"

• "What are the recent customer reviews?"

• "Create a new app store version"

• "Add a beta tester to my TestFlight group"

Remote Deployment with OAuth

Auth0 Setup (for Remote Access)

1. Create Auth0 API:

   • Log into Auth0 Dashboard

   • Create new API (not Application)

   • Note the Identifier (becomes your audience)

2. Configure OAuth Settings:

OAUTH_ENABLED=true
AUTH0_DOMAIN=https://your-tenant.auth0.com
AUTH0_AUDIENCE=https://your-api-identifier

3. Deploy to Vercel:

vercel --prod

4. Configure Claude Desktop for Remote Access:

{
  "mcpServers": {
    "appstore-connect": {
      "url": "https://your-deployment.vercel.app/mcp"
    }
  }
}

Claude will automatically discover OAuth configuration and handle authentication.

Authentication

This server supports two authentication modes:

• Local: Direct API key authentication with Apple Store Connect

• Remote: OAuth 2.0 via Auth0 for secure remote access

Requirements

• Valid Apple Developer Program membership

• App Store Connect access

• API key with appropriate permissions (typically App Manager or Admin)

License

MIT License - see LICENSE file for details

Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests for any improvements.

Support

• Create an issue for bugs or feature requests

• Check Apple's App Store Connect API documentation for API-specific questions