Play Store MCP Server

An MCP (Model Context Protocol) server that enables interaction with Google Play Console to deploy and manage Android applications.

⚠️ Development Status

Although it's currently functional, this MCP server is under development. Please use with caution and thoroughly test in non-production environments first.

If you encounter any issues or have feature requests, please open an issue on GitHub. Your feedback is valuable for improving this project.

What is this?

This MCP server provides tools to:

• Deploy new versions of Android applications
• Promote releases between tracks (internal → alpha → beta → production)
• Query the status of existing releases

Available Tools

1. deploy_app

Deploys a new version of an application to the Play Store.

Parameters:

• packageName (string): App package name (e.g., com.example.myapp)
• track (string): Release track (internal, alpha, beta, production)
• apkPath (string): Path to APK or AAB file
• versionCode (integer): Version code (must be higher than current)
• releaseNotes (string, optional): Release notes
• rolloutPercentage (number, optional): Rollout percentage (0.0 to 1.0, default: 1.0 for full rollout)

2. promote_release

Promotes an existing version from one track to another.

Parameters:

• packageName (string): App package name
• fromTrack (string): Source track (internal, alpha, beta)
• toTrack (string): Target track (alpha, beta, production)
• versionCode (integer): Version code to promote

3. get_releases

Gets the current status of app releases and deployments for a specific package.

Parameters:

• packageName (string): App package name (e.g., com.example.myapp)

Setup

1. Google Cloud and Play Console Setup

Step 1: Create a Google Cloud Console project

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Play Android Developer API:
   • Go to "APIs & Services" → "Library"
   • Search for "Google Play Android Developer API"
   • Click "Enable"

Step 2: Create a service account

1. In Google Cloud Console, go to "IAM & Admin" → "Service Accounts"
2. Click "Create Service Account"
3. Fill in the details:
   • Name: play-store-mcp
   • Description: Service account for Play Store MCP operations
4. Click "Create and Continue"
5. In "Grant this service account access to project", you don't need to assign specific roles
6. Click "Done"

Step 3: Generate the service account key

1. In the service accounts list, find the one you just created
2. Click on the service account email
3. Go to the "Keys" tab
4. Click "Add Key" → "Create new key"
5. Select "JSON" as the key type
6. Click "Create"
7. A JSON file will download - this is your service-account-key.json

Step 4: Configure permissions in Google Play Console

1. Go to Google Play Console
2. Select your developer account
3. Go to "Users and Permssions"
4. Click "Invite new users"
5. Add the email of the service account
6. Click "Invite User"
7. Configure the necessary permissions:
   • App permissions: Select the apps it can manage
   • Account permissions: Grant "View app information" and the permissions aunder "Versions"

More permissions may be required when new features are released.

2. MCP Client Configuration

Add the following configuration to your MCP configuration file:

{
  "mcpServers": {
    "play-store-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/play-store-mcp-all.jar"
      ],
      "env": {
        "PLAY_STORE_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json",
        "PLAY_STORE_DEFAULT_TRACK": "internal"
      }
    }
  }
}

Environment Variables

• PLAY_STORE_SERVICE_ACCOUNT_KEY_PATH: Path to the service account JSON file (required)

... View full README on GitHub