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

Setup

Prerequisites

Node.js 18+
Apple Developer Account with App Store Connect access
App Store Connect API key

Apple Store Connect API Key Setup

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

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)

Create Auth0 API:
- Log into Auth0 Dashboard
- Create new API (not Application)
- Note the Identifier (becomes your audience)
Configure OAuth Settings:

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

Deploy to Vercel:

vercel --prod

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

appstore-connect-mcp

Documentation