App Store Connect MCP server

The App Store Connect MCP Server provides tools for interacting with the App Store Connect API, allowing you to manage your iOS and macOS apps, beta testers, app metadata, and more through conversational AI. This server bridges the gap between AI and Apple's App Store Connect ecosystem.

Installation

Using Smithery

To install the server for Claude Desktop automatically:

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

Manual Installation

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

Configuration

Add the following to your Claude Desktop configuration file:

macOS

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

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@joshuarileydev/app-store-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

1. Generate an App Store Connect API Key from App Store Connect
2. Download the .p8 private key file
3. Note your Key ID and Issuer ID
4. 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 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".

Using the MCP Server

App Management Tools

List Apps

Get a list of all apps in App Store Connect.

Example:

"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.

Example:

"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).

Example:

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

Manage Beta Testers

Add or remove testers from beta groups.

Example:

"Add [email protected] to beta group ABC123"
"Add John Smith ([email protected]) to group ABC123"
"Remove tester XYZ789 from group ABC123"

View Beta Feedback

List and view beta feedback with screenshots.

Example:

"Show beta feedback screenshots for app 123456789"
"Get feedback screenshot FEEDBACK123"

App Store Version Localization Tools

Create App Store Versions

Create new app store versions with scheduled releases.

Example:

"Create iOS version 2.0.0 for app 123456789"
"Create scheduled iOS version 2.1.0 for app 123456789 releasing on 2024-02-01"

Manage Localizations

Update app descriptions, keywords, and promotional text.

Example:

"List all localizations for app version VERSION123"
"Update description for localization LOCALE123 to 'Amazing new app description'"
"Change keywords for LOCALE123 to 'productivity, tasks, organize'"

Bundle ID Management Tools

Create and List Bundle IDs

Register and manage bundle IDs for app development.

Example:

"Create bundle ID com.mycompany.newapp for iOS named 'My New App'"
"List all bundle IDs"
"Show iOS bundle IDs sorted by name"

Manage Capabilities

Enable or disable capabilities for bundle IDs.

Example:

"Enable push notifications for bundle ID BUNDLE123"
"Disable capability CAP123"

Device Management Tools

List and filter registered devices.

Example:

"List all devices"
"Show enabled iOS devices"
"Find devices with name containing 'John'"

Analytics & Reports Tools

Generate Analytics Reports

Create and download analytics reports for your apps.

Example:

"Create daily analytics report for app 123456789"
"List reports for request REQ123"
"Download data from [URL]"

Sales & Finance Reports

Download sales and finance reports (requires vendor number).

Example:

"Download daily sales summary for 2024-01-15"
"Get monthly subscription detailed report for 2024-01"
"Download finance report for January 2024 worldwide"

Xcode Development Tools

List available schemes in Xcode projects and workspaces.

Example:

"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

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "app-store-connect" '{"command":"npx","args":["-y","@joshuarileydev/app-store-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"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "app-store-connect": {
            "command": "npx",
            "args": [
                "-y",
                "@joshuarileydev/app-store-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"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "app-store-connect": {
            "command": "npx",
            "args": [
                "-y",
                "@joshuarileydev/app-store-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"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect