playstore-mcp

Play Store MCP Server

An MCP (Model Context Protocol) server that wraps Google's Android Publisher API, giving AI assistants the ability to manage Play Store apps, releases, reviews, listings, and more — right from your IDE.

Getting Your API Credentials

You need a Google Cloud service account with Play Console access. Here's how to set it up:

• Go to Google Cloud Console → IAM & Admin → Service Accounts
• Select your project (or create one)
• Click Create Service Account
• Give it a name (e.g. "MCP Server") and click Create and Continue
• Skip the optional roles step — click Done
• Click on the newly created service account, go to the Keys tab
• Click Add Key → Create new key → JSON and download the file
• Save the JSON key file somewhere secure (e.g. ~/.google/play-service-account.json)

Enable the Google Play Developer API

• Go to Google Cloud Console → Google Play Android Developer API
• Make sure your project is selected, then click Enable

Grant Play Console Access

• Go to Google Play Console → Users and permissions
• Click Invite new users
• Enter the service account's client_email (found in the JSON key file, e.g. [e-mail])
• Under App permissions, add the apps you want the service account to access
• Grant the necessary permissions (e.g. View app information and download bulk reports, Manage production releases, Reply to reviews)
• Click Invite user

Important: You need account owner or admin permissions in the Play Console to invite new users. If you don't have either role, ask someone who does to complete this step.

Credential	Where to find it
Service Account JSON Key	Downloaded in step 7 — contains client_email, private_key, and project_id

Note: The JSON key file can only be downloaded once when created. If lost, generate a new key from the Keys tab.

Setup

Claude

Claude Code (CLI)

claude mcp add playstore \
  --transport stdio \
  --env GOOGLE_SERVICE_ACCOUNT_KEY_PATH=/absolute/path/to/service-account.json \
  -- npx -y playstore-mcp

Claude Desktop

Add to your claude_desktop_config.json:

OS	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "playstore": {
      "command": "npx",
      "args": ["-y", "playstore-mcp"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/service-account.json"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "playstore": {
      "command": "npx",
      "args": ["-y", "playstore-mcp"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/service-account.json"
      }
    }
  }
}

Verify under Cursor Settings → MCP after restarting.

Antigravity

Add to ~/.gemini/antigravity/mcp_config.json (or via Agent pane → MCP Servers → Manage MCP Servers → View raw config):

{
  "mcpServers": {
    "playstore": {
      "command": "npx",
      "args": ["-y", "playstore-mcp"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/service-account.json"
      }
    }
  }
}

Tip: Run npx -y playstore-mcp once in your terminal first so the package is cached — Antigravity's first-run timeout can otherwise cause the server to fail to start.

Available Tools

Tool	Description
get_app_details	Get app details by package name
list_tracks	List release tracks (production, beta, alpha, internal)
get_track	Get details of a specific release track
list_reviews	List user reviews for an app
reply_to_review	Reply to a user review
list_listings	List all store listings (all locales)
get_listing	Get store listing for a specific locale
update_listing	Update store listing for a locale
list_inapp_products	List managed in-app products
get_inapp_product	Get details of a specific in-app product
list_subscriptions	List subscriptions for an app
get_subscription	Get details of a specific subscription
list_testers	List testers for a specific track
update_testers	Update testers (Google Groups) for a track

License

MIT