> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Play CLI

> Run Google Play Console from your terminal, CI, or AI agent with gps, its MCP server, and the hosted MCP.

`gps` is a scriptable CLI, MCP server, and TypeScript SDK for the Google Play Android Publisher API: releases and staged rollouts, store listings, reviews, testers, subscriptions, in-app products, purchases, and orders.

Open source: [github.com/appeeky/google-play-console-cli](https://github.com/appeeky/google-play-console-cli) · Full reference: [gps.appeeky.com](https://gps.appeeky.com)

| Package | Binaries | Role |
| - | - | - |
| `@appeeky/google-play-store-cli` | `gps`, `gps-mcp` | CLI and stdio MCP server |

## Two ways to use it

| | Hosted MCP | Local CLI / MCP |
| - | - | - |
| Credentials | Your Google Play connection in Appeeky | Your own service-account JSON key |
| Setup | Paste one MCP config | `npm install -g` |
| Uploads (AAB, APK, images) | Not available | Yes |
| Usage | Counts toward your Appeeky API credits | Free |

**Hosted MCP**

Connect Google Play once in Appeeky (**Settings → Data sources**), then add the server with your [Appeeky API key](/docs/authentication.md):

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "mcpServers": {
    "google-play": {
      "url": "https://gps-api.appeeky.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_APPEEKY_API_KEY"
      }
    }
  }
}
```

Start with `gps_list_apps`. The server is read-only until you add `"X-GPS-Allow-Writes": "true"`. See [Hosted MCP](/docs/store-cli-google-play-hosted-mcp.md).

**Local CLI**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npm install -g @appeeky/google-play-store-cli
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
gps whoami
```

See [Install & auth](/docs/store-cli-google-play-install.md).

## What you can do

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gps --package com.example.app tracks list --json
gps --package com.example.app reviews list --json
gps --package com.example.app reviews reply REVIEW_ID "Thanks!" --confirm
gps --package com.example.app deploy --file ./app.aab --track internal --confirm
gps --package com.example.app tracks rollout production --user-fraction 0.1 --confirm
```

Commands that change your Play Console need `--confirm`. Add `--read-only` to block writes entirely.

| Area | CLI commands | Guide |
| - | - | - |
| Releases | `deploy`, `tracks`, `internal-sharing` | [Releases & rollouts](/docs/store-cli-google-play-releases.md) |
| Store presence | `listings`, `reviews`, `testers` | [Listings & reviews](/docs/store-cli-google-play-listings-reviews.md) |
| Monetization | `subscriptions`, `otp`, `iap`, `convert-prices`, `purchases`, `orders` | [Monetization](/docs/store-cli-google-play-monetization.md) |
| Accounts | `accounts`, `apps`, `whoami` | [Install & auth](/docs/store-cli-google-play-install.md) |
| Everything else | `ops`, `search`, `capabilities`, `call` | [MCP tools](/docs/store-cli-google-play-mcp-tools.md) |

Every operation has one name (for example `gps_list_tracks`) shared by `gps call`, the local MCP server, the hosted MCP, and the REST API.

## Global flags

| Flag | Description |
| - | - |
| `-c, --credentials <path\|json>` | Service-account JSON path or inline JSON |
| `-a, --account <id>` | Named account from `~/.config/gps/config.json` |
| `-p, --package <name>` | Application package name |
| `--json` | Machine-readable JSON output |
| `--read-only` | Block write operations |
| `--confirm` | Required for commands that change Play Console |

If `--package` is omitted, the account's default package is used.

## Agent skills

`gps install-skills` installs workflow skills for coding agents: releases, listings, reviews, monetization, MCP, and troubleshooting.

## Next

> **[Hosted MCP](/docs/store-cli-google-play-hosted-mcp.md)**
>
> No key file: run on your Appeeky connection.

> **[Install & auth](/docs/store-cli-google-play-install.md)**
>
> Service account, env vars, and multiple accounts.

> **[REST API](/docs/store-cli-google-play-rest-api.md)**
>
> `/v1/apps`, `/v1/ops`, and error codes.

> **[Google Play Console in Appeeky](/docs/google-play-connect.md)**
>
> Dashboards, vitals, and report exports.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.