gpc-mcp-server

🤖 Google Play Console MCP Server

A powerful Model Context Protocol (MCP) server that allows AI Assistants (like Claude, Gemini, or any MCP client) to directly manage your Google Play Console.

Stop clicking through slow web interfaces to release your app. Just ask your AI agent to do it.

"Claude, what's the crash rate on production?" "Gemini, create a new internal release and update the release notes." "Claude, list 1-star reviews from today and reply to them asking for details."

---

🌟 Key Features

• 🚀 Release Management: Create releases, manage tracks, update release notes, and control staged rollouts.
• 📊 App Vitals & Reports: Fetch acquisition data, crash rates, and ANR statistics instantly.
• 💬 Review Management: Read user reviews, filter by rating, and post replies automatically.
• 🖼️ Store Presence: Update store listings, translations, and manage screenshots/feature graphics.

🛠️ Provided Tools

This MCP server exposes 65 tools to your AI agent. Highlights:

📦 App & Listings

• gpc_get_app_info - Get app details (package name, default language, contact info)
• gpc_list_listings - Fetch all store listings across locales
• gpc_update_listing - Update store listing for a specific locale

🚀 Release & Track Management

• gpc_list_tracks - List tracks (internal, alpha, beta, production) with current releases
• gpc_create_release - Create a new release on a specified track
• gpc_update_release_notes - Update release notes for the latest release
• gpc_set_rollout - Set/update staged rollout percentage
• gpc_halt_rollout - Halt an ongoing staged rollout

💬 Reviews

• gpc_list_reviews - Fetch user reviews with ratings and reply status
• gpc_reply_review - Post a reply to a user review

📈 Reports & Vitals

• gpc_acquisition_report - Fetch install/acquisition statistics
• gpc_crash_report - Get Crash and ANR rates from Android Vitals
• gpc_crash_anomaly_detector - Compares the last 2 days' crash rate against the prior 12-day baseline and flags a spike (🚨) worth halting a rollout for

📸 Screenshots & Images

• gpc_list_images - List uploaded images for a specific locale
• gpc_upload_image - Upload screenshots/feature graphics/icons
• gpc_upload_images_batch - Upload many images across locales in a single edit (required to seed a new locale: Play demands ≥2 phone screenshots at commit time, so per-file commits fail with "too few screenshots")
• gpc_delete_image - Delete a specific image

---

⚙️ Quick Start

1. Obtain a Service Account Key

1. Go to Google Cloud Console.
2. Enable the "Google Play Android Developer API".
3. Create a Service Account and download the JSON key.
4. In Google Play Console > Setup > API access:
   • Link your Google Cloud project.
   • Grant the service account "Admin" or "Release manager" permissions.

2. Installation

Clone this repository and build:

git clone https://github.com/YOUR_USERNAME/gpc-mcp-server.git
cd gpc-mcp-server
npm install
npm run build

3. Connect to Claude Code (or any MCP Client)

Use the claude mcp add command to inject this server into your Claude environment:

claude mcp add --scope user gpc-mcp \
  -e GOOGLE_PLAY_SERVICE_ACCOUNT_JSON=/path/to/your/service-account.json \
  -e GOOGLE_PLAY_PACKAGE_NAME=com.yourcompany.appname \
  -- node /path/to/gpc-mcp-server/dist/index.js

Environment Variables Required

Variable	Description	Example
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON	Absolute path to the Service Account JSON key	/users/me/secrets/play-store.json
GOOGLE_PLAY_PACKAGE_NAME	Your Android application package name	com.example.myapp

---

🤖 Example AI Prompts

Once configured, you can just talk to your AI agent naturally:

Checking App Health:

"Are there any new crashes for our app today?" -> Agent calls gpc_crash_report

Rollout Safety Check:

"Is our latest rollout safe, or should we halt it?" -> Agent calls gpc_crash_anomaly_detector, and if it flags a spike, follows up with gpc_halt_rollout

Release Workflow:

"Create a new internal release and update the Turkish release notes to say 'Bug fixes'." -> Agent calls gpc_create_release and gpc_update_release_notes

Customer Support:

"Find all 1-star reviews from this week and draft replies for me." -> Agent calls gpc_list_reviews and gpc_reply_review

Auto-Generate Release Notes from Git:

"Look at the commits since our last tag and write user-friendly release notes from them, then publish them." -> Agent reads your local git history, drafts copy, and calls gpc_update_release_notes

Store Listing Optimization:

"Pull our current store listing and suggest a stronger short description for better conversion." -> Agent calls gpc_list_listings to read the current copy, then gpc_update_listing to publish the new one

---

📝 Supported Locales

Includes standard Play Console locales: en-US, tr-TR, de-DE, es-419, fr-FR, ru-RU, ar and many more.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.