Skip to main content

Prerequisites

  • Node.js 20+
  • A Google Cloud service account with the Google Play Android Developer API enabled
  • That service account invited in Play Console → Users and permissions with the rights you need

Install

This installs both binaries:
  • gps — CLI
  • gps-mcp — MCP server
Other package managers:
From source (contributors):

Authenticate

Export a path to your service-account JSON (recommended):
Or pass it per command:
See Authentication for full precedence and config file support.

First commands

Multiple keys / apps

One service account can access many apps (Play Console grants). Publisher API cannot list apps — register packages locally:
See Multi-account and apps. Write operations require --confirm:

Call any operation

Ergonomic CLI subcommands cover common workflows. Everything else is reachable via the shared registry:
The same names are MCP tools — see MCP setup.

Read-only mode

Block commits and mutations:
Ephemeral edits used for reads (tracks, listings) still work in read-only mode; they are never committed.