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

• Install
• Quick start
• Multi-account
• Common workflows
• MCP
• gps skills
• SDK
• Documentation
• Development
• Contributing
• License

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 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.

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

• Site: gps.appeeky.com
• Source: docs/

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.