Google Play Console MCP

A Python Model Context Protocol server that

lets AI assistants (Claude, etc.) manage the full Google Play Store release

lifecycle directly — from uploading artifacts to managing testers, rollouts,

and Android Vitals.

Quick start

Option A — `uvx` (recommended, no install needed)

Run this once. Claude automatically starts and stops the server for every session — you never have to touch it again.

claude mcp add google-play-mcp \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json \
  -- uvx google-play-mcp

> Requires `uv` — install with `brew install uv` or `curl -Lsf https://astral.sh/uv/install.sh | sh`

Option B — `pip install`

If you prefer a permanent install:

pip install google-play-mcp

claude mcp add google-play-mcp \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json \
  -- google-play-mcp

Option C — HTTP (local server)

Only needed if you want to connect via HTTP transport instead of stdio:

# Terminal 1 — start the server
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json \
  uvx google-play-mcp --transport http --port 8080

# Terminal 2 — register with Claude
claude mcp add --transport http google-play-mcp http://localhost:8080

> How stdio works: With Options A and B, there is no server to start manually.

> Claude launches the process in the background when a session opens and shuts it

> down when the session ends. Zero maintenance.

Features

Tracks & Releases

Artifact Management

Tester Management

Android Vitals

Prerequisites

1. `uv` — install guide

2. A Google Cloud service account with the JSON key downloaded.

3. The service account added to Google Play Console with the correct permissions (see below).

4. These APIs enabled in your Google Cloud project:

Required Play Console permissions

> Important: Release Manager does not grant Reporting API access. You must also enable

> View app information and download bulk reports (read-only) — both at account level and

> per-app level — for the Vitals tools to work.

Claude Desktop integration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

{
  "mcpServers": {
    "google-play": {
      "command": "uvx",
      "args": ["google-play-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account.json"
      }
    }
  }
}

Restart Claude Desktop after saving.

Service account setup

1. Go to IAM & Admin → Service Accounts in your GCP project.

2. Create a service account (or use an existing one) and download a JSON key.

3. In Google Play Console → Setup → API access:

> Permissions must be granted at both account level and per-app level.

> Account-level alone is not sufficient for the Reporting API.

Tool reference

`list_tracks`

package_name : str  — e.g. "com.example.myapp"

Returns all tracks with their releases, rollout percentages, statuses, and country availability.

`get_track_info`

package_name : str
track        : str  — "internal" | "alpha" | "beta" | "production" (default: "production")

Returns a human-readable summary plus releases with status, rollout %, version codes, and release notes.

`create_release`

package_name       : str
track              : str        — "internal" | "alpha" | "beta" | "production"
version_codes      : list[int]  — e.g. [1042]
rollout_percentage : float      — default 10.0 (used when status is "inProgress")
status             : str        — "draft" (default) | "inProgress" | "halted" | "completed"
release_name       : str        — optional
release_notes      : dict       — optional, e.g. {"en-US": "Bug fixes", "fr-FR": "Corrections"}
country_codes      : list[str]  — optional ISO 3166-1 alpha-2 codes, e.g. ["US", "GB"]

Creates or replaces a release on the given track. Use `status="inProgress"` with a

`rollout_percentage` for a staged production rollout, or `status="completed"` to release

to all users immediately.

`update_release`

package_name       : str
track              : str    — default "production"
rollout_percentage : float  — optional; pass 100 to complete the rollout
status             : str    — optional; "inProgress" | "halted" | "completed" | "draft"
version_codes      : list[int]  — optional filter; targets first matching release if omitted

Update an existing release. Common use cases:

• Increase rollout: `update_release(pkg, rollout_percentage=50)`
• Complete rollout: `update_release(pkg, rollout_percentage=100)`
• Halt rollout: `update_release(pkg, status="halted")`
• Resume rollout: `update_release(pkg, status="inProgress")`

`promote_release`

package_name       : str
from_track         : str        — "internal" | "alpha" | "beta"
to_track           : str        — "alpha" | "beta" | "production"
version_codes      : list[int]
rollout_percentage : float      — default 10.0
release_name       : str        — optional override
release_notes      : dict       — optional override; inherits from source if omitted

Copies a release from one track to another. Release notes and name are inherited from the

source release unless explicitly overridden.

`list_artifacts`

package_name : str

Returns all APKs and AABs sorted by version code (newest first) with SHA hashes.

`upload_artifact`

package_name       : str
file_path          : str    — absolute local path to .apk or .aab
track              : str    — default "internal"
status             : str    — "draft" (default) | "inProgress" | "completed"
rollout_percentage : float  — default 10.0 (used when status is "inProgress")
release_name       : str    — optional
release_notes      : dict   — optional

Uploads an APK or AAB (auto-detected from extension) and creates a release on the given

track in a single atomic operation. Returns the assigned version code.

`upload_to_internal_sharing`

package_name : str
file_path    : str  — absolute local path to .apk or .aab

Uploads a build to Internal App Sharing (bypasses track assignment) and returns a

shareable `downloadUrl`. Testers must have Internal App Sharing enabled in their Play

Store settings. Ideal for quick one-off testing without affecting any release track.

`get_testers`

package_name : str
track        : str  — "internal" (default) | "alpha"

Returns the list of tester email addresses and Google Groups for the track.

`update_testers`

package_name  : str
track         : str         — "internal" (default) | "alpha"
emails        : list[str]   — optional; full replacement list of tester emails
google_groups : list[str]   — optional; full replacement list of Google Group emails

> Warning: This is a full replacement. Testers not in the new list will lose access.

> Call `get_testers` first to retrieve the current list if you only want to add/remove individuals.

`get_crash_rate`

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

Returns daily `crashRate`, `userPerceivedCrashRate`, and `distinctUsers` per version code.

Google's bad behavior threshold for user-perceived crash rate is ~1.09%.

`get_anr_rate`

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

Returns daily `anrRate`, `userPerceivedAnrRate`, and `distinctUsers` per version code.

Google's bad behavior threshold for user-perceived ANR rate is ~0.47%.

`get_vitals_summary`

package_name : str
days         : int  — look-back window, 1–30 (default 7)

Returns a combined crash + ANR summary aggregated per version code, with averages over

the period and `exceedsCrashThreshold` / `exceedsAnrThreshold` flags. The latest version

is highlighted as `latestVersionSummary`.

`get_wakelock_rate`

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

Returns daily `stuckBackgroundWakelockRate` and `distinctUsers` per version code.

Relevant for 2026 Google Play battery health enforcement — apps with an excessive

proportion of sessions holding a partial wake lock for more than 1 hour in the background

may be penalized.

`get_wakeup_rate`

package_name : str
days         : int  — look-back window, 1–30 (default 7)
version_code : str  — optional single version code to filter

Returns daily `excessiveWakeupRate` and `distinctUsers` per version code.

Relevant for 2026 Google Play battery health enforcement — apps that wake the CPU too

frequently (above platform thresholds) may be penalized.

Troubleshooting

`403 Forbidden` on Vitals tools

403 Client Error: Forbidden for url: https://playdeveloperreporting.googleapis.com/...

This error has two common causes — check both:

1. Google Play Developer Reporting API not enabled

Enable it in your Google Cloud project:

console.cloud.google.com/apis/library/playdeveloperreporting.googleapis.com

2. Service account lacks per-app Reporting API access

1. Play Console → Setup → API access → find the service account → Manage Play Console permissions.

2. Under App permissions, select the app and enable View app information and download bulk reports (read-only).

3. Save and wait a few minutes for the change to propagate.

`404 Package not found`

The service account must be linked to the same Google Play Console account that owns the app.

Go to Play Console → Setup → API access and verify the service account is listed and has been invited.

Marketplaces

License

MIT