Store Automation MCP

MCP (Model Context Protocol) server for automating Google Play Store and Apple App Store submissions.

Works with Claude Desktop, Cursor, and other MCP-compatible AI tools.

Features

Subscription Tools

• subscription_status - Check your subscription status
• activate_subscription - Activate PRO with your email
• refresh_subscription - Refresh subscription from server
• deactivate_subscription - Deactivate on this device

Google Play Store (PRO)

• google_play_get_metadata - Get app metadata
• google_play_update_metadata - Update app metadata
• google_play_create_release - Create a new release
• google_play_upload_bundle - Upload AAB/APK and create release

Apple App Store (PRO)

• app_store_get_metadata - Get app metadata
• app_store_update_metadata - Update app metadata
• app_store_submit_for_review - Submit for review
• app_store_get_review_status - Check review status
• app_store_upload_ipa - Upload IPA file (API key auth)
• app_store_upload_ipa_with_password - Upload IPA file (Apple ID auth)

Free Tools

• validate_metadata - Validate metadata (character limits, etc.)

Pricing

Subscribe at: https://8566730725923.gumroad.com/l/cemyz

| Feature | Free | PRO ($4.99/mo) | |---------|------|----------------| | validate_metadata | ✅ | ✅ | | Google Play metadata | ❌ | ✅ | | Google Play AAB/APK upload | ❌ | ✅ | | App Store metadata | ❌ | ✅ | | App Store IPA upload | ❌ | ✅ |

Installation

npm install -g store-automation-mcp

Quick Start

1. Install the package
2. Subscribe at https://8566730725923.gumroad.com/l/cemyz
3. Activate with activate_subscription tool using your email
4. Configure your Google Play / App Store credentials

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GOOGLE_PLAY_CLIENT_EMAIL | For Google Play | Service account email | | GOOGLE_PLAY_PRIVATE_KEY | For Google Play | Service account private key | | APP_STORE_ISSUER_ID | For App Store | App Store Connect Issuer ID | | APP_STORE_KEY_ID | For App Store | App Store Connect Key ID | | APP_STORE_PRIVATE_KEY | For App Store | App Store Connect private key |

Google Play Store Setup

1. Google Cloud Console → Create new project
2. Enable Google Play Android Developer API
3. Create service account → Download JSON key
4. Google Play Console → Settings → API access → Grant permissions

Apple App Store Setup

1. App Store Connect → Users and Access → Keys
2. Generate API Key (Admin role)
3. Download .p8 file
4. Note Issuer ID and Key ID

Usage with Claude Desktop

Add to claude_desktop_config.json:

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

{
  "mcpServers": {
    "store-automation": {
      "command": "npx",
      "args": ["-y", "store-automation-mcp"],
      "env": {
        "GOOGLE_PLAY_CLIENT_EMAIL": "[email protected]",
        "GOOGLE_PLAY_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "YOUR10CHAR",
        "APP_STORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

Usage with Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "store-automation": {
      "command": "node",
      "args": ["/path/to/store-automation-mcp/dist/index.js"],
      "env": {
        "GOOGLE_PLAY_CLIENT_EMAIL": "[email protected]",
        "GOOGLE_PLAY_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "YOUR10CHAR",
        "APP_STORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

Or for global setup, add to ~/.claude/settings.json:

{
  "mcpServers": {
    "store-automation": {
      "command": "npx",
      "args": ["-y", "store-automation-mcp"],
      "env": {
        "GOOGLE_PLAY_CLIENT_EMAIL": "...",
        "GOOGLE_PLAY_PRIVATE_KEY": "...",
        "APP_STORE_ISSUER_ID": "...",
        "APP_STORE_KEY_ID": "...",
        "APP_STORE_PRIVATE_KEY": "..."
      }
    }
  }
}

Usage with Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "store-automation": {
      "command": "npx",
      "args": ["-y", "store-automation-mcp"],
      "env": {
        "GOOGLE_PLAY_CLIENT_EMAIL": "[email protected]",
        "GOOGLE_PLAY_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "YOUR10CHAR",
        "APP_STORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

Activating PRO

After subscribing, activate your subscription:

"Activate my subscription with email [email protected]"

Or use the activate_subscription tool directly with your Gumroad purchase email.

Example Prompts

Subscription

"Check my subscription status"

"Activate my subscription with email [email protected]"

Google Play Store

"Get the current metadata for com.example.app"

"Update the description for com.example.app:
- Title: My App
- Short description: The best app ever
- Full description: This app is amazing..."

"Create a release for com.example.app version 2.0.0 on the beta track"

"Upload ./build/app-release.aab to Google Play for com.example.app on internal track"

Apple App Store

"Get the metadata for app ID 123456789"

"Update the description for app ID 123456789"

"Submit app ID 123456789 for review"

"Check the review status for app ID 123456789"

"Upload ./build/MyApp.ipa to App Store Connect"

Platform Limits

Google Play

| Field | Limit | |-------|-------| | Title | 30 chars | | Short description | 80 chars | | Full description | 4,000 chars | | Release notes | 500 chars |

App Store

| Field | Limit | |-------|-------| | App name | 30 chars | | Subtitle | 30 chars | | Description | 4,000 chars | | Keywords | 100 chars | | What's new | 4,000 chars |

Troubleshooting

"PRO subscription required" error

• Subscribe at https://8566730725923.gumroad.com/l/cemyz
• Use activate_subscription tool with your email

"No active subscription found" error

• Check you're using the same email as your Gumroad purchase
• Try refresh_subscription to update from server

"Missing Google Play credentials" error

• Verify GOOGLE_PLAY_CLIENT_EMAIL and GOOGLE_PLAY_PRIVATE_KEY are set
• Make sure \n in private key is correctly formatted

"Missing App Store credentials" error

• Verify APP_STORE_ISSUER_ID, APP_STORE_KEY_ID, and APP_STORE_PRIVATE_KEY
• Make sure Key ID is exactly 10 characters

Google Play API permission error

• Check service account permissions in Google Play Console
• Required: View app information, Manage releases, Manage store presence

"Xcode Command Line Tools not installed" error (App Store upload)

• Run xcode-select --install to install Xcode Command Line Tools
• macOS only - IPA upload requires Xcode tools

"Invalid file type" error

• Google Play: Use .aab (recommended) or .apk files
• App Store: Use .ipa files only

Support

• Email: [email protected]
• Issues: https://github.com/alyduho/store-automation-mcp/issues