App Store Connect MCP Server

A Model Context Protocol (MCP) server for interacting with the App Store Connect API. This server provides tools for managing apps, beta testers, bundle IDs, devices, app metadata, and capabilities in App Store Connect.

Overview

The App Store Connect MCP Server is a comprehensive tool that bridges the gap between AI and Apple's App Store Connect ecosystem. Built on the Model Context Protocol (MCP), this server enables developers to interact with their App Store Connect data directly through conversational AI, making app management, beta testing, and analytics more accessible than ever.

Key Benefits:

🤖 AI-Powered App Management: Use natural language to manage your iOS and macOS apps
📊 Comprehensive Analytics: Access detailed app performance, sales, and user engagement data
👥 Streamlined Beta Testing: Efficiently manage beta groups and testers
🌍 Localization Management: Update app descriptions, keywords, and metadata across all languages
🔧 Developer Tools Integration: List Xcode project schemes and integrate with development workflows
🔐 Secure Authentication: Uses official App Store Connect API with JWT authentication
🚀 Real-time Data: Access up-to-date information directly from Apple's systems

Who This Is For:

iOS/macOS developers managing apps in App Store Connect
Development teams coordinating beta testing programs
Product managers analyzing app performance and user engagement
Marketing teams managing app metadata and localizations
DevOps engineers automating app store workflows
Anyone looking to streamline their Apple developer experience

This server transforms complex App Store Connect operations into simple conversational commands, whether you're checking app analytics, managing beta testers, updating app descriptions, or exploring your development pipeline.

Features

App Management
- List all apps
- Get detailed app information
- View app metadata and relationships
Beta Testing
- List beta groups
- List beta testers
- Add/remove testers from groups
- Manage beta test configurations
- View beta feedback with screenshots and device information
App Store Version Localizations ✨ NEW
- Create new app store versions with release scheduling
- List all app store versions for an app
- List all localizations for an app version
- Get specific localization details
- Update app descriptions, keywords, and promotional text
- Manage marketing and support URLs
- Update "What's New" text for releases
Bundle ID Management
- List bundle IDs
- Create new bundle IDs
- Get bundle ID details
- Enable/disable capabilities
Device Management
- List registered devices
- Filter by device type, platform, status
- View device details
User Management
- List team members
- View user roles and permissions
- Filter users by role and access
Analytics & Reports
- Create analytics report requests for apps
- Download App Store engagement, commerce, and usage analytics
- Access performance and frameworks usage reports
- Download sales and trends reports (daily, weekly, monthly, yearly)
- Download finance reports by region
Xcode Development Tools
- List available schemes in Xcode projects and workspaces
- Integrate with development workflows and CI/CD pipelines

Installation

Using Smithery

To install App Store Connect Server for Claude Desktop automatically:

hljs language-bash

npx @smithery/cli install appstore-connect-mcp-server --client claude

Manual Installation

hljs language-bash

npm install @joshuarileydev/app-store-connect-mcp-server

Configuration

Add the following to your Claude Desktop configuration file:

macOS

hljs language-bash

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

hljs language-bash

%APPDATA%\Claude\claude_desktop_config.json

hljs language-json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "appstore-connect-mcp-server"
      ],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/your/auth-key.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER_OPTIONAL"
      }
    }
  }
}

Authentication

Required Configuration

Generate an App Store Connect API Key from App Store Connect
Download the .p8 private key file
Note your Key ID and Issuer ID
Set the required environment variables in your configuration:
- APP_STORE_CONNECT_KEY_ID: Your API Key ID
- APP_STORE_CONNECT_ISSUER_ID: Your Issuer ID
- APP_STORE_CONNECT_P8_PATH: Path to your .p8 private key file

Optional Configuration for Sales & Finance Reports

To enable sales and finance reporting tools, you'll also need:

APP_STORE_CONNECT_VENDOR_NUMBER: Your vendor number from App Store Connect

Note: Sales and finance report tools (download_sales_report, download_finance_report) will only be available if the vendor number is configured. You can find your vendor number in App Store Connect under "Sales and Trends" or "Payments and Financial Reports".

Complete Tool Reference

📱 App Management Tools

`list_apps`

Get a list of all apps in App Store Connect.

Parameters:

limit (optional): Maximum number of apps to return (default: 100, max: 200)
bundleId (optional): Filter by bundle identifier

Example:

hljs language-arduino

"List all my apps"
"Show me apps with bundle ID com.example.myapp"
"Get the first 50 apps"

`get_app_info`

Get detailed information about a specific app.

Parameters:

appId (required): The ID of the app
include (optional): Related resources to include (e.g., appClips, appInfos, appStoreVersions, betaGroups, builds)

Example:

hljs language-arduino

"Get info for app ID 123456789"
"Show me app 123456789 with beta groups and builds"
"Get detailed information about my app including app store versions"

👥 Beta Testing Tools

`list_beta_groups`

List all beta testing groups (internal and external).

Parameters:

limit (optional): Maximum number of groups to return (default: 100, max: 200)
appId (optional): Filter by app ID

Example:

hljs language-arduino

"Show all beta groups"
"List beta groups for app 123456789"
"Get the first 20 beta groups"

`list_group_testers`

List testers in a specific beta group.

Parameters:

groupId (required): The ID of the beta group
limit (optional): Maximum number of testers to return (default: 100, max: 200)

Example:

hljs language-arduino

"List all testers in group ABC123"
"Show me the first 50 testers in beta group ABC123"

`add_tester_to_group`

Add a new tester to a beta group.

Parameters:

groupId (required): The ID of the beta group
email (required): Email address of the tester
firstName (optional): Tester's first name
lastName (optional): Tester's last name

Example:

hljs language-less

"Add john@example.com to beta group ABC123"
"Add John Smith (john@example.com) to group ABC123"

`remove_tester_from_group`

Remove a tester from a beta group.

Parameters:

groupId (required): The ID of the beta group
testerId (required): The ID of the tester

Example:

hljs language-arduino

"Remove tester XYZ789 from group ABC123"
"Delete tester XYZ789 from beta group ABC123"

`list_beta_feedback_screenshots`

List beta feedback screenshot submissions.

Parameters:

appId (optional): Filter by app ID
bundleId (optional): Filter by bundle identifier
buildId (optional): Filter by build ID
limit (optional): Maximum results (default: 100)
includeBuilds (optional): Include build information
includeTesters (optional): Include tester information

Example:

hljs language-arduino

"Show beta feedback screenshots for app 123456789"
"List feedback screenshots for bundle ID com.example.app"
"Get feedback with tester info for build XYZ"

`get_beta_feedback_screenshot`

Get detailed information about a specific beta feedback screenshot.

Parameters:

feedbackId (required): The ID of the feedback
includeBuilds (optional): Include build information
includeTesters (optional): Include tester information
downloadScreenshot (optional): Download the screenshot image (default: true)

Example:

hljs language-arduino

"Get feedback screenshot FEEDBACK123"
"Show me feedback FEEDBACK123 with tester details"
"Download screenshot from feedback FEEDBACK123"

🌍 App Store Version Localization Tools

`create_app_store_version`

Create a new app store version for an app.

Parameters:

appId (required): The ID of the app
platform (required): The platform (IOS, MAC_OS, TV_OS, VISION_OS)
versionString (required): Version string in format X.Y or X.Y.Z (e.g., '1.0' or '1.0.0')
copyright (optional): Copyright text for this version
releaseType (optional): How the app should be released (MANUAL, AFTER_APPROVAL, SCHEDULED)
earliestReleaseDate (optional): ISO 8601 date string (required when releaseType is SCHEDULED)
buildId (optional): ID of the build to associate with this version

Example:

hljs language-arduino

"Create iOS version 2.0.0 for app 123456789"
"Create macOS version 1.5.0 for app 123456789 with manual release"
"Create scheduled iOS version 2.1.0 for app 123456789 releasing on 2024-02-01"
"Create version 1.2.0 for app 123456789 with build BUILD456 and copyright '2024 My Company'"

`list_app_store_versions`

Get all app store versions for a specific app.

Parameters:

appId (required): The ID of the app
limit (optional): Maximum number of versions to return (default: 100, max: 200)
filter (optional): Filter options
- platform: Filter by platform (IOS, MAC_OS, TV_OS)
- versionString: Filter by version string (e.g., '1.0.0')
- appStoreState: Filter by state (e.g., READY_FOR_SALE, PREPARE_FOR_SUBMISSION)

Example:

hljs language-arduino

"List all versions for app 123456789"
"Show iOS versions for app 123456789"
"Find version 2.0.0 for app 123456789"
"List versions in review for app 123456789"

`list_app_store_version_localizations`

Get all localizations for a specific app store version.

Parameters:

appStoreVersionId (required): The ID of the app store version
limit (optional): Maximum number of localizations (default: 100, max: 200)

Example:

hljs language-arduino

"List all localizations for app version VERSION123"
"Show me language versions for app store version VERSION123"

`get_app_store_version_localization`

Get detailed information about a specific localization.

Parameters:

localizationId (required): The ID of the localization

Example:

hljs language-arduino

"Get localization details for LOCALE123"
"Show me the French localization LOCALE123"

`update_app_store_version_localization`

Update a specific field in an app store version localization.

Parameters:

localizationId (required): The ID of the localization
field (required): Field to update (description, keywords, marketingUrl, promotionalText, supportUrl, whatsNew)
value (required): New value for the field

Example:

hljs language-css

"Update description for localization LOCALE123 to 'Amazing new app description'"
"Change keywords for LOCALE123 to 'productivity, tasks, organize'"
"Update what's new text for LOCALE123 to 'Bug fixes and performance improvements'"

🔤 Bundle ID Management Tools

`create_bundle_id`

Parameters:

identifier (required): The bundle ID string (e.g., 'com.example.app')
name (required): A name for the bundle ID
platform (required): Platform (IOS, MAC_OS, or UNIVERSAL)
seedId (optional): Your team's seed ID

Example:

hljs language-arduino

"Create bundle ID com.mycompany.newapp for iOS named 'My New App'"
"Register universal bundle ID com.example.app called 'Example App'"

`list_bundle_ids`

Find and list bundle IDs registered to your team.

Parameters:

limit (optional): Maximum results (default: 100, max: 200)
sort (optional): Sort order (name, -name, platform, -platform, identifier, -identifier)
filter (optional): Filter by identifier, name, platform, or seedId
include (optional): Include related resources (profiles, bundleIdCapabilities, app)

Example:

hljs language-arduino

"List all bundle IDs"
"Show iOS bundle IDs sorted by name"
"Find bundle IDs containing 'example'"

`get_bundle_id_info`

Get detailed information about a specific bundle ID.

Parameters:

bundleIdId (required): The ID of the bundle ID
include (optional): Related resources to include
fields (optional): Specific fields to include

Example:

hljs language-arduino

"Get info for bundle ID BUNDLE123"
"Show bundle ID BUNDLE123 with capabilities"

`enable_bundle_capability`

Enable a capability for a bundle ID.

Parameters:

bundleIdId (required): The ID of the bundle ID
capabilityType (required): Type of capability (e.g., PUSH_NOTIFICATIONS, ICLOUD, GAME_CENTER)
settings (optional): Capability-specific settings

Example:

hljs language-arduino

"Enable push notifications for bundle ID BUNDLE123"
"Add iCloud capability to bundle BUNDLE123"
"Enable Game Center for bundle ID BUNDLE123"

`disable_bundle_capability`

Disable a capability for a bundle ID.

Parameters:

capabilityId (required): The ID of the capability to disable

Example:

hljs language-arduino

"Disable capability CAP123"
"Remove capability CAP123 from bundle ID"

📱 Device Management Tools

`list_devices`

Get a list of all devices registered to your team.

Parameters:

limit (optional): Maximum results (default: 100, max: 200)
sort (optional): Sort order (name, platform, status, udid, deviceClass, model, addedDate)
filter (optional): Filter by name, platform, status, udid, or deviceClass
fields (optional): Specific fields to include

Example:

hljs language-arduino

"List all devices"
"Show enabled iOS devices"
"Find devices with name containing 'John'"
"List iPhones sorted by date added"

👤 User Management Tools

`list_users`

Get a list of all users on your App Store Connect team.

Parameters:

limit (optional): Maximum results (default: 100, max: 200)
sort (optional): Sort order (username, firstName, lastName, roles)
filter (optional): Filter by username or roles
fields (optional): Specific fields to include
include (optional): Include visibleApps relationship

Example:

hljs language-arduino

"List all team members"
"Show users with admin role"
"Find developers sorted by last name"
"List users with their visible apps"

📊 Analytics & Reports Tools

`create_analytics_report_request`

Create a new analytics report request for an app.

Parameters:

appId (required): The app ID
accessType (required): Type of analytics (ONGOING or ONE_TIME_SNAPSHOT)
frequency (optional): Report frequency for ongoing reports (DAILY, WEEKLY, MONTHLY)
startDate (optional): Start date (YYYY-MM-DD)
endDate (optional): End date (YYYY-MM-DD)

Example:

hljs language-css

"Create daily analytics report for app 123456789"
"Generate one-time snapshot report for app 123456789 from 2024-01-01 to 2024-01-31"

`list_analytics_reports`

Get available analytics reports for a request.

Parameters:

reportRequestId (required): The report request ID
limit (optional): Maximum results (default: 100, max: 200)
filter (optional): Filter by category, name, or date

Example:

hljs language-arduino

"List reports for request REQ123"
"Show app usage reports for request REQ123"

`list_analytics_report_segments`

Get segments for a specific analytics report.

Parameters:

reportId (required): The analytics report ID
limit (optional): Maximum results (default: 100, max: 200)

Example:

hljs language-arduino

"List segments for report REPORT123"
"Get download URLs for report REPORT123"

`download_analytics_report_segment`

Download data from an analytics report segment.

Parameters:

url (required): The segment download URL

Example:

hljs language-arduino

"Download data from https://api.appstoreconnect.apple.com/..."

💰 Sales & Finance Reports Tools (Requires Vendor Number)

`download_sales_report`

Download sales and trends reports.

Parameters:

frequency (required): Report frequency (DAILY, WEEKLY, MONTHLY, YEARLY)
reportDate (required): Date in appropriate format
reportType (required): Type of report (SALES, SUBSCRIPTION, SUBSCRIPTION_EVENT, SUBSCRIBER, NEWSSTAND, PREORDER)
reportSubType (required): SUMMARY or DETAILED
vendorNumber (optional): Override default vendor number
version (optional): Report version (default: 1_0)

Example:

hljs language-arduino

"Download daily sales summary for 2024-01-15"
"Get monthly subscription detailed report for 2024-01"
"Download yearly sales summary for 2023"

`download_finance_report`

Download finance reports for a specific region.

Parameters:

reportDate (required): Report date (YYYY-MM)
regionCode (required): Region code (e.g., 'Z1' for worldwide)
vendorNumber (optional): Override default vendor number

Example:

hljs language-arduino

"Download finance report for January 2024 worldwide"
"Get finance report for 2024-01 region Z1"

🔧 Xcode Development Tools

`list_schemes`

List all available schemes in an Xcode project or workspace.

Parameters:

projectPath (required): Path to .xcodeproj or .xcworkspace file

Example:

hljs language-arduino

"List schemes in /Users/john/MyApp/MyApp.xcodeproj"
"Show available schemes for MyApp.xcworkspace"

Error Handling

The server implements proper error handling for:

Invalid authentication
Missing required parameters
API rate limits
Network issues
Invalid operations

Development

hljs language-bash

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run type checking
npm run type-check

License

This project is licensed under the MIT License - see the LICENSE file for details.

app-store-connect-mcp-server

App Store Connect MCP Server

Overview

Features

Installation

Using Smithery

Manual Installation

Configuration

macOS

Windows

Authentication

Required Configuration

Optional Configuration for Sales & Finance Reports

Complete Tool Reference

📱 App Management Tools

list_apps

get_app_info

👥 Beta Testing Tools

list_beta_groups

list_group_testers

add_tester_to_group

remove_tester_from_group

list_beta_feedback_screenshots

get_beta_feedback_screenshot

🌍 App Store Version Localization Tools

create_app_store_version

list_app_store_versions

list_app_store_version_localizations

get_app_store_version_localization

update_app_store_version_localization

🔤 Bundle ID Management Tools

create_bundle_id

list_bundle_ids

get_bundle_id_info

enable_bundle_capability

disable_bundle_capability

📱 Device Management Tools

list_devices

👤 User Management Tools

list_users

📊 Analytics & Reports Tools

create_analytics_report_request

list_analytics_reports

list_analytics_report_segments

download_analytics_report_segment

💰 Sales & Finance Reports Tools (Requires Vendor Number)

download_sales_report

download_finance_report

🔧 Xcode Development Tools

list_schemes

Error Handling

Development

License

Related Links

Similar Packages

Security

Original Author

Publisher

`list_apps`

`get_app_info`

`list_beta_groups`

`list_group_testers`

`add_tester_to_group`

`remove_tester_from_group`

`list_beta_feedback_screenshots`

`get_beta_feedback_screenshot`

`create_app_store_version`

`list_app_store_versions`

`list_app_store_version_localizations`

`get_app_store_version_localization`

`update_app_store_version_localization`

`create_bundle_id`

`list_bundle_ids`

`get_bundle_id_info`

`enable_bundle_capability`

`disable_bundle_capability`

`list_devices`

`list_users`

`create_analytics_report_request`

`list_analytics_reports`

`list_analytics_report_segments`

`download_analytics_report_segment`

`download_sales_report`

`download_finance_report`

`list_schemes`