Google Play Console MCP

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:

• Google Play Android Developer API
• Google Play Developer Reporting API

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:

• Link your Google Cloud project.
• Find the service account → Manage Play Console permissions.
• Under Account permissions, enable View app information and download bulk reports (read-only).
• Under App permissions for each app, enable:
• View app information and download bulk reports (read-only)
• Release to production… _(if you need write access)_
• Click Apply → Invite user.

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