Skip to main content
Glama
appeeky

Google Play Store CLI MCP

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: play-store-mcp

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: --credentialsGPS_CREDENTIALS / GOOGLE_PLAY_CREDENTIALSGOOGLE_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

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.

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/appeeky/google-play-console-cli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server