{"_id":"@appeeky/google-play-store-cli","_rev":"3-bda04091fd44abfd7e57932049aeb624","name":"@appeeky/google-play-store-cli","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@appeeky/google-play-store-cli","version":"0.1.0","keywords":["google-play","android-publisher","cli","mcp","gps","gps-mcp","appeeky"],"license":"MIT","_id":"@appeeky/google-play-store-cli@0.1.0","maintainers":[{"name":"erencan","email":"erencan_arica@hotmail.com"}],"homepage":"https://github.com/appeeky/google-play-store-cli#readme","bugs":{"url":"https://github.com/appeeky/google-play-store-cli/issues"},"bin":{"gps":"dist/bin.js","gps-mcp":"dist/mcp-bin.js"},"dist":{"shasum":"ad38aae8a0bafaa9c85828820c71a5efa914f894","tarball":"https://registry.npmjs.org/@appeeky/google-play-store-cli/-/google-play-store-cli-0.1.0.tgz","fileCount":22,"integrity":"sha512-sqjITXt3FF+TcUDXFs4QKb84BosoBoHQFhbRfxLJOewVWBbtAcPrHxsIcDHPRkMWNLuDb+wNeH4AgFbU5Ny1Fg==","signatures":[{"sig":"MEYCIQCnJHYVIFqKPKZ5yqTxRltiq7oFbCnGgJiRU49W3yTU8QIhALpK6P4JLce0Uba6Ef+gLuWmdS4e3CZzSdXmxyN3ccis","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":950645},"main":"./dist/bin.js","type":"module","_from":"file:appeeky-google-play-store-cli-0.1.0.tgz","types":"./dist/bin.d.ts","scripts":{},"_npmUser":{"name":"erencan","email":"erencan_arica@hotmail.com"},"_resolved":"/private/var/folders/l1/6sxn612j4hsfy3619mqs_sz00000gn/T/1519982adeab3606ab45441a05c9769c/appeeky-google-play-store-cli-0.1.0.tgz","_integrity":"sha512-sqjITXt3FF+TcUDXFs4QKb84BosoBoHQFhbRfxLJOewVWBbtAcPrHxsIcDHPRkMWNLuDb+wNeH4AgFbU5Ny1Fg==","repository":{"url":"git+https://github.com/appeeky/google-play-store-cli.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.9.8","description":"gps + gps-mcp — Google Play Store CLI and MCP server (Android Publisher API v3)","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.24.3","commander":"^13.1.0","googleapis":"^173.0.0","google-auth-library":"^10.9.1","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/google-play-store-cli_0.1.0_1785194794569_0.378922258777074","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@appeeky/google-play-store-cli","version":"0.1.1","keywords":["google-play","android-publisher","cli","mcp","gps","gps-mcp","appeeky"],"license":"MIT","_id":"@appeeky/google-play-store-cli@0.1.1","maintainers":[{"name":"erencan","email":"erencan_arica@hotmail.com"}],"homepage":"https://github.com/appeeky/google-play-store-cli#readme","bugs":{"url":"https://github.com/appeeky/google-play-store-cli/issues"},"bin":{"gps":"dist/bin.js","gps-mcp":"dist/mcp-bin.js"},"dist":{"shasum":"3b790fa44678d19eb1b6d4355f03ea1c4bf0c548","tarball":"https://registry.npmjs.org/@appeeky/google-play-store-cli/-/google-play-store-cli-0.1.1.tgz","fileCount":23,"integrity":"sha512-+2crIbDrSEqn3sv8G2pR8SzkRl5SqyvW5Cl0lLSsWtck+8IJZZcDddYMqs/uRYcbHsGnMl/CW/XOOpuYyrbNtA==","signatures":[{"sig":"MEUCIBAlLqScB7/jfInfhUNT7rV/wQtPN61D0yzMpLqP/bjYAiEAqCt3w37EbkfyCVKnEH2PgAHyJFokk7RaA9nGDmvx60o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":955901},"main":"./dist/bin.js","type":"module","_from":"file:appeeky-google-play-store-cli-0.1.1.tgz","types":"./dist/bin.d.ts","scripts":{},"_npmUser":{"name":"erencan","email":"erencan_arica@hotmail.com"},"_resolved":"/private/var/folders/l1/6sxn612j4hsfy3619mqs_sz00000gn/T/d645ce92aaf6ebacf196d91bffe294de/appeeky-google-play-store-cli-0.1.1.tgz","_integrity":"sha512-+2crIbDrSEqn3sv8G2pR8SzkRl5SqyvW5Cl0lLSsWtck+8IJZZcDddYMqs/uRYcbHsGnMl/CW/XOOpuYyrbNtA==","repository":{"url":"git+https://github.com/appeeky/google-play-store-cli.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.9.8","description":"gps + gps-mcp — Google Play Store CLI and MCP server (Android Publisher API v3)","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^3.24.3","commander":"^13.1.0","googleapis":"^173.0.0","google-auth-library":"^10.9.1","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/google-play-store-cli_0.1.1_1785194903062_0.5349533064360339","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@appeeky/google-play-store-cli","version":"0.1.2","description":"gps + gps-mcp — Google Play Store CLI and MCP server (Android Publisher API v3)","license":"MIT","type":"module","bin":{"gps":"dist/bin.js","gps-mcp":"dist/mcp-bin.js"},"main":"./dist/bin.js","types":"./dist/bin.d.ts","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"repository":{"type":"git","url":"git+https://github.com/appeeky/google-play-store-cli.git","directory":"packages/cli"},"homepage":"https://github.com/appeeky/google-play-store-cli#readme","bugs":{"url":"https://github.com/appeeky/google-play-store-cli/issues"},"keywords":["google-play","android-publisher","cli","mcp","gps","gps-mcp","appeeky"],"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","commander":"^13.1.0","google-auth-library":"^10.9.1","googleapis":"^173.0.0","zod":"^3.24.3"},"scripts":{},"_id":"@appeeky/google-play-store-cli@0.1.2","_integrity":"sha512-naa/KbabWYqQLpMfPzIK+4cmZj6AzWEipkL4IGx6D93EP6cbD19+pb8cGW7g9QtDpx217NfYP1nEcd2FZJ15tA==","_resolved":"/private/var/folders/l1/6sxn612j4hsfy3619mqs_sz00000gn/T/e89af3ee46d5fe134a17eec79e7bb721/appeeky-google-play-store-cli-0.1.2.tgz","_from":"file:appeeky-google-play-store-cli-0.1.2.tgz","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-naa/KbabWYqQLpMfPzIK+4cmZj6AzWEipkL4IGx6D93EP6cbD19+pb8cGW7g9QtDpx217NfYP1nEcd2FZJ15tA==","shasum":"7ba4838e7dfe5e60166ae1ad3c597d79ed48759f","tarball":"https://registry.npmjs.org/@appeeky/google-play-store-cli/-/google-play-store-cli-0.1.2.tgz","fileCount":23,"unpackedSize":956168,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDi7eMOvz8ZoTcaFKvvFQ7hbG25wZsh47nPtVC3rbGsGQIgBHjvUz4BnQkegI/MWb4jMsMgzqDS/i6T+0Wv1Z1noDE="}]},"_npmUser":{"name":"erencan","email":"erencan_arica@hotmail.com"},"directories":{},"maintainers":[{"name":"erencan","email":"erencan_arica@hotmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/google-play-store-cli_0.1.2_1785196092356_0.881649009825443"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-27T23:26:34.387Z","modified":"2026-07-27T23:48:12.664Z","0.1.0":"2026-07-27T23:26:34.738Z","0.1.1":"2026-07-27T23:28:23.198Z","0.1.2":"2026-07-27T23:48:12.502Z"},"bugs":{"url":"https://github.com/appeeky/google-play-store-cli/issues"},"license":"MIT","homepage":"https://github.com/appeeky/google-play-store-cli#readme","keywords":["google-play","android-publisher","cli","mcp","gps","gps-mcp","appeeky"],"repository":{"type":"git","url":"git+https://github.com/appeeky/google-play-store-cli.git","directory":"packages/cli"},"description":"gps + gps-mcp — Google Play Store CLI and MCP server (Android Publisher API v3)","maintainers":[{"name":"erencan","email":"erencan_arica@hotmail.com"}],"readme":"# Google Play Store CLI\n\n**Powered by [Appeeky](https://appeeky.com).**\n\nA scriptable **CLI + MCP** for the [Google Play Android Publisher API v3](https://developers.google.com/android-publisher).\n\nAutomate Android release workflows from your terminal, IDE, or CI — deploy builds, manage listings, reply to reviews, and operate monetization.\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/appeeky/google-play-store-cli/main/images/hero.jpg\" alt=\"Appeeky — CLI, MCP, and TypeScript SDK for the Google Play Android Publisher API\" width=\"100%\" />\n</p>\n\n| Package | Binaries | Role |\n| ------- | -------- | ---- |\n| [`@appeeky/google-play-store-cli`](https://www.npmjs.com/package/@appeeky/google-play-store-cli) | `gps`, `gps-mcp` | CLI + MCP server |\n\nDocs: [gps.appeeky.com](https://gps.appeeky.com) · Repo: [appeeky/google-play-store-cli](https://github.com/appeeky/google-play-store-cli)\n\n## Table of contents\n\n- [Install](#install)\n- [Quick start](#quick-start)\n- [Multi-account](#multi-account)\n- [Common workflows](#common-workflows)\n- [MCP](#mcp)\n- [gps skills](#gps-skills)\n- [Documentation](#documentation)\n- [Development](#development)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Install\n\n```bash\nnpm install -g @appeeky/google-play-store-cli\n```\n\nThis installs both binaries:\n\n- `gps` — CLI\n- `gps-mcp` — MCP server (stdio)\n\n```bash\ngps --help\ngps-mcp --help\n```\n\nAlso available with other package managers:\n\n```bash\npnpm add -g @appeeky/google-play-store-cli\nyarn global add @appeeky/google-play-store-cli\nbun add -g @appeeky/google-play-store-cli\n```\n\n## Quick start\n\n### 1. Authenticate\n\n1. Create a Google Cloud **service account** and enable the Google Play Android Developer API.\n2. Invite the SA email in Play Console → **Users and permissions**.\n3. Download the JSON key (never commit it).\n\n```bash\nexport GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json\ngps whoami\n```\n\nOr:\n\n```bash\ngps --credentials /path/to/service-account.json whoami\n```\n\nCredential precedence: `--credentials` → `GPS_CREDENTIALS` / `GOOGLE_PLAY_CREDENTIALS` → `GOOGLE_APPLICATION_CREDENTIALS` → `~/.config/gps/config.json`.\n\n### 2. First commands\n\n```bash\ngps --package com.example.app --json tracks list\ngps --package com.example.app --json listings list\ngps --package com.example.app --json reviews list\n```\n\nWrites need `--confirm`:\n\n```bash\ngps --package com.example.app deploy \\\n  --file ./app-release.aab \\\n  --track internal \\\n  --confirm\n```\n\n## Multi-account\n\nOne service-account key can access **many apps** (Play Console grants). Google Publisher API has **no** `list_apps` — register packages locally:\n\n```bash\ngps accounts add my-co --credentials /path/to/sa.json --default-package com.example.app --default\ngps apps add com.example.app --account my-co --name \"My App\" --default\ngps apps list\ngps --account my-co tracks list\n```\n\nDetails: [docs/authentication-accounts.mdx](https://github.com/appeeky/google-play-store-cli/blob/main/docs/authentication-accounts.mdx).\n\n## Common workflows\n\n### Releases\n\n```bash\ngps --package com.example.app deploy --file ./app.aab --track internal --confirm\ngps --package com.example.app tracks promote --from internal --to beta --confirm\ngps --package com.example.app tracks rollout production --user-fraction 0.1 --confirm\ngps --package com.example.app tracks halt production --confirm\n```\n\n### Reviews\n\n```bash\ngps --package com.example.app reviews list --json\ngps --package com.example.app reviews reply REVIEW_ID \"Thanks!\" --confirm\n```\n\n### Listings\n\n```bash\ngps --package com.example.app listings list\ngps --package com.example.app listings update en-US --title \"My App\" --confirm\n```\n\n### Monetization\n\n```bash\ngps --package com.example.app subscriptions list --json\ngps --package com.example.app otp list\ngps --package com.example.app iap list\n```\n\n### Full API surface\n\n```bash\ngps ops monetization\ngps call gps_list_reviews '{\"packageName\":\"com.example.app\"}'\n```\n\n## MCP\n\n```json\n{\n  \"mcpServers\": {\n    \"google-play-store\": {\n      \"command\": \"gps-mcp\",\n      \"args\": [\"--credentials\", \"/path/to/service-account.json\"]\n    }\n  }\n}\n```\n\nRead-only:\n\n```bash\ngps-mcp --read-only --credentials ./sa.json\n```\n\nSee [docs/mcp/setup.mdx](https://github.com/appeeky/google-play-store-cli/blob/main/docs/mcp/setup.mdx).\n\n## gps skills\n\nAgent Skills for automating `gps` workflows including releases, listings, reviews, monetization, MCP, and troubleshooting.\n\n```bash\ngps install-skills\n```\n\nOr:\n\n```bash\nnpx skills add ./skills --skill '*' -a cursor -a claude-code -g -y\n```\n\nDocs: [docs/skills/overview.mdx](https://github.com/appeeky/google-play-store-cli/blob/main/docs/skills/overview.mdx).\n\n## Documentation\n\n- Site: [gps.appeeky.com](https://gps.appeeky.com)\n- Source: [`docs/`](./docs)\n\n```bash\ncd docs && npx mintlify dev\n```\n\n## Development\n\n```bash\ngit clone https://github.com/appeeky/google-play-store-cli.git\ncd google-play-store-cli\npnpm install\npnpm build\npnpm test\npnpm typecheck\n```\n\n## Contributing\n\nContributions are welcome. See [CONTRIBUTING.md](https://github.com/appeeky/google-play-store-cli/blob/main/CONTRIBUTING.md) for setup, package layout, and testing notes.\n\n## License\n\nMIT — see [LICENSE](https://github.com/appeeky/google-play-store-cli/blob/main/LICENSE).\n\n---\n\nThis 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.\n","readmeFilename":"README.md"}