Skip to main content
Glama
Google Play Store MCP Server

Google Play Store MCP Server

by appeeky

Google Play Store CLI

Powered by Appeeky.

A scriptable CLI + MCP for the Google Play Android Publisher API v3.

Automate Android release workflows from your terminal, IDE, or CI — deploy builds, manage listings, reply to reviews, and operate monetization.

Package

Binaries

Role

@appeeky/google-play-store-cli

gps, gps-mcp

CLI + MCP server

Table of contents

Related MCP server: dev-publish

Install

npm install -g @appeeky/google-play-store-cli

This installs both binaries:

  • gps — CLI

  • gps-mcp — MCP server (stdio)

gps --help
gps-mcp --help

Also available with other package managers:

pnpm add -g @appeeky/google-play-store-cli
yarn global add @appeeky/google-play-store-cli
bun add -g @appeeky/google-play-store-cli

Quick start

1. Authenticate

  1. Create a Google Cloud service account and enable the Google Play Android Developer API.

  2. Invite the SA email in Play Console → Users and permissions.

  3. Download the JSON key (never commit it).

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
gps whoami

Or:

gps --credentials /path/to/service-account.json whoami

Credential precedence: --credentials → GPS_CREDENTIALS / GOOGLE_PLAY_CREDENTIALS → GOOGLE_APPLICATION_CREDENTIALS → ~/.config/gps/config.json.

2. First commands

gps --package com.example.app --json tracks list
gps --package com.example.app --json listings list
gps --package com.example.app --json reviews list

Writes need --confirm:

gps --package com.example.app deploy \
  --file ./app-release.aab \
  --track internal \
  --confirm

Multi-account

One service-account key can access many apps (Play Console grants). Google Publisher API has no list_apps — register packages locally:

gps accounts add my-co --credentials /path/to/sa.json --default-package com.example.app --default
gps apps add com.example.app --account my-co --name "My App" --default
gps apps list
gps --account my-co tracks list

Details: docs/authentication-accounts.mdx.

Common workflows

Releases

gps --package com.example.app deploy --file ./app.aab --track internal --confirm
gps --package com.example.app tracks promote --from internal --to beta --confirm
gps --package com.example.app tracks releases production --version-code 123 --json
gps --package com.example.app tracks rollout production --user-fraction 0.1 --confirm
gps --package com.example.app tracks halt production --confirm

Reviews

gps --package com.example.app reviews list --json
gps --package com.example.app reviews reply REVIEW_ID "Thanks!" --confirm

Listings

gps --package com.example.app listings list
gps --package com.example.app listings update en-US --title "My App" --confirm

Monetization

gps --package com.example.app subscriptions list --json
gps --package com.example.app otp list
gps --package com.example.app iap list

Full API surface

gps ops monetization
gps call gps_list_reviews '{"packageName":"com.example.app"}'

MCP

{
  "mcpServers": {
    "google-play-store": {
      "command": "gps-mcp",
      "args": ["--credentials", "/path/to/service-account.json"]
    }
  }
}

Read-only:

gps-mcp --read-only --credentials ./sa.json

See docs/mcp/setup.mdx.

Hosted, without a key file (uses your Google Play connection in Appeeky):

{
  "mcpServers": {
    "google-play-store": {
      "url": "https://gps-api.appeeky.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_APPEEKY_API_KEY" }
    }
  }
}

See docs/mcp/hosted.mdx.

gps skills

Agent Skills for automating gps workflows including releases, listings, reviews, monetization, MCP, and troubleshooting.

gps install-skills

Or:

npx skills add ./skills --skill '*' -a cursor -a claude-code -g -y

Docs: docs/skills/overview.mdx.

SDK

The same Publisher client ships as a TypeScript SDK in this monorepo (packages/core, import @appeeky/google-play-store-core). It is bundled into the published CLI/MCP package and is not published separately on npm yet. See docs/sdk/overview.mdx.

Documentation

cd docs && npx mintlify dev

Development

git clone https://github.com/appeeky/google-play-store-cli.git
cd google-play-store-cli
pnpm install
pnpm build
pnpm test
pnpm typecheck

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, package layout, and testing notes.

License

MIT — see LICENSE.


This project is an independent tool for the Google Play Android Publisher API and is not affiliated with, endorsed by, or sponsored by Google LLC. Google Play and Android are trademarks of Google LLC.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to manage Google Play Console reviews and Android app releases, including replying to reviews, promoting releases, managing staged rollouts, and checking crash/ANR vitals.
      44
      46 npm
      2
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables AI agents to manage Google Play apps with scope-based permissions, including publishing internal releases, updating listings, replying to reviews, and promoting to production.
      11
      8 npm
      -
    • A
      license
      B
      quality
      C
      maintenance
      Gives AI assistants hands-on control over Google Play Console and Google Cloud Console using an authorized Google identity. Exposes 95 tools for shipping app builds and release tracks, managing store listings, reviews, in-app products, GCP projects and IAM, Firebase projects and App Distribution, and Cloud Storage or Artifact Registry resources.
      95
      MIT