# Google Play Store MCP server

> Provides AI agents with read-only access to public Google Play Store data including app details, search results, reviews, and developer information.

- Repository: https://github.com/kryuchenko/google-play-scraper
- Page: https://hostedmcp.org/servers/kryuchenko/gpscrape
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.1.2

## Install

### Claude Code

```sh
claude mcp add gpscrape -- docker run -i --rm ghcr.io/kryuchenko/gpscrape-mcp:0.1.2
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "gpscrape": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kryuchenko/gpscrape-mcp:0.1.2"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "gpscrape": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kryuchenko/gpscrape-mcp:0.1.2"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"gpscrape","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/kryuchenko/gpscrape-mcp:0.1.2"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "gpscrape": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kryuchenko/gpscrape-mcp:0.1.2"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add gpscrape -- docker run -i --rm ghcr.io/kryuchenko/gpscrape-mcp:0.1.2
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.gpscrape]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/kryuchenko/gpscrape-mcp:0.1.2"]
```

### Gemini CLI

```sh
gemini mcp add -s user gpscrape docker -- run -i --rm ghcr.io/kryuchenko/gpscrape-mcp:0.1.2
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "gpscrape": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/kryuchenko/gpscrape-mcp:0.1.2"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GPSCRAPE_MCP_TOKEN` | no | no |  |

## Tools (21)

- `play_search_apps`
- `play_get_app`
- `play_get_apps`
- `play_get_chart`
- `play_get_reviews`
- `play_get_similar_apps`
- `play_get_developer_apps`
- `play_get_permissions`
- `play_get_data_safety`
- `play_suggest_queries`
- `play_list_categories`
- `play_check_availability`
- `invalid_argument`
- `not_found`
- `not_listed`
- `rate_limited`
- `timeout`
- `busy`
- `cancelled`
- `store_error`
- `internal`

## FAQ

### What kind of data can I access?

You can access app details, search results, charts, reviews, similar apps, developer listings, permissions, data safety, and per-country availability.

### How do I install the server?

You can install it via Go using `go install github.com/kryuchenko/google-play-scraper/mcp/cmd/gpscrape-mcp@latest` or use prebuilt binaries and Docker containers.

### Can I use this with ChatGPT?

Yes, but since ChatGPT cannot start local processes, you must host the server yourself and provide the token as part of the URL.

### Is the data safe to use as instructions?

No, third-party text like reviews and descriptions are marked as untrusted data so the agent knows to treat them as data rather than instructions.
