MCP server for searching and downloading Android APKs from Google Play

Ask your AI assistant to find or download any Android app — no Google account required

---

Connect your AI assistant to Google Play. Search for apps, inspect metadata, list available splits, or download APKs — all through natural conversation. Uses anonymous authentication via the Aurora Store token dispenser; no Google account needed.

Quick Start

1. Install

curl -sSL https://galimru.github.io/apkdl-mcp/install.sh | sh

Or download a binary from the releases page.

2. Connect to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "apkdl": {
      "command": "/path/to/apkdl-mcp"
    }
  }
}

On first run the server fetches an anonymous auth token and caches it to ~/.config/apkdl-mcp/. Subsequent starts reuse the cached token and only refresh when it expires (~50 minutes).

Tools

Tool	What it does
search_apps	Search Google Play by keyword — returns package names, titles, developers
get_app_info	Get metadata for a specific app: version, developer, rating, Play Store URL
list_splits	List available split APK names for an app
download_apk	Download base APK, splits, and OBB files to a local directory

Configuration

Config file

~/.config/apkdl-mcp/config.json is created on first run with defaults:

{
  "default_arch": "arm64",
  "output_dir": ".",
  "dispenser_url": ""
}

Field	Default	Description
default_arch	"arm64"	CPU architecture: "arm64" or "armv7"
output_dir	"."	Default directory for downloaded APK files
dispenser_url	""	Custom token dispenser URL (leave empty for Aurora Store default)

Environment variables

Variable	Description
APKDL_DEBUG	Set to any non-empty value to log HTTP traffic to stderr

Notes

• This project is not affiliated with Google or Aurora Store.
• Only free apps can be downloaded anonymously. Paid apps and apps with geographic restrictions may not be available.
• Downloaded APKs are for the architecture specified in default_arch (arm64 by default).

Contributing

Bug fixes and clear improvements are welcome. Open an issue first for anything non-trivial.

License

MIT