App Store Connect MCP

A Model Context Protocol (MCP) server for interacting with Apple's App Store Connect API. This tool enables automated management of iOS apps, builds, TestFlight beta testing, and user access control through a standardized interface.

Features

Authentication

• Store and validate App Store Connect API credentials

• Automatic JWT token generation for API requests

App Management

• List all apps in your account

• Get app details by ID or bundle ID

• Retrieve app metadata and configuration

Build Management

• List builds for any app

• Get specific build details

• Find the latest build for an app

• Filter builds by version or processing state

TestFlight Integration

• List and manage beta groups

• Add builds to beta groups

• Add beta testers to groups

• Configure testing access

User Management

• List team members and their roles

• Invite new users to the team

• Manage user permissions and access

Related MCP server: App Store Connect MCP

Prerequisites

• Node.js 18.0.0 or higher

• App Store Connect API credentials:

  • API Key ID

  • Issuer ID (Team ID)

  • Private Key (.p8 file)

Installation

Claude Code

claude mcp add appstore-connect-mcp -- npx appstore-connect-mcp

Setup

1. Generate an App Store Connect API key:

   • Go to App Store Connect

   • Navigate to Users and Access → Keys

   • Create a new key with desired permissions

   • Download the .p8 private key file

   • Note your Key ID and Issuer ID

2. Configure the MCP server in Claude Desktop:

   npm run mcp:add

   Or manually add to your Claude configuration:

   {
     "mcpServers": {
       "appstore-connect-mcp": {
         "command": "node",
         "args": ["/path/to/appstore-connect-mcp/dist/index.js"]
       }
     }
   }

Usage

1. Store Credentials

First, store your App Store Connect credentials:

appstore_store_credentials
- keyId: Your API Key ID
- issuerId: Your Team ID
- privateKey: Contents of your .p8 file (include BEGIN/END markers)

2. Validate Credentials

Verify your credentials are working:

appstore_validate_credentials

3. Available Tools

Apps

• appstore_list_apps - List all apps

• appstore_get_app - Get app by ID or bundle ID

Builds

• appstore_list_builds - List builds for an app

• appstore_get_build - Get specific build details

• appstore_get_latest_build - Get the most recent build

TestFlight

• appstore_list_beta_groups - List beta testing groups

• appstore_add_build_to_beta_group - Add build to testing

• appstore_add_beta_tester - Add new beta tester

Users

• appstore_list_users - List team members

• appstore_invite_user - Invite new team member

API Client Generation

To regenerate the API client from OpenAPI spec:

npm run generate:api

Security

• Credentials are stored in memory only during the session

• Private keys are validated before use

• JWT tokens are generated with 20-minute expiration

• All API requests use HTTPS

Error Handling

The server provides detailed error messages for common issues:

• Invalid credentials

• Missing permissions

• API rate limits

• Network errors

License

MIT