Android Docs

An MCP (Model Context Protocol) server that gives AI agents direct access to developer.android.com — search docs, look up API references, browse packages, and check release notes.

Quick Start

No installation needed — run directly with npx or bunx:

npx android-docs-mcp

bunx android-docs-mcp

Usage

VS Code

Add to your .vscode/mcp.json (or use the included one if cloning the repo):

{
  "servers": {
    "android-docs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "android-docs-mcp"]
    }
  }
}

Claude Desktop / Cursor / other MCP clients

Add to your MCP config:

{
  "mcpServers": {
    "android-docs": {
      "command": "npx",
      "args": ["-y", "android-docs-mcp"]
    }
  }
}

From source

git clone https://github.com/ankit-verma-209171/android-docs-mcp.git
cd android-docs-mcp
bun install
bun run dev

Tools

search_android_docs

Search across all Android documentation.

Parameter	Type	Default	Description
query	string	(required)	Search query
max_results	number	10	Max results (1–30)

get_android_doc_page

Fetch and parse any developer.android.com page into Markdown.

Parameter	Type	Description
url	string	Full URL to a developer.android.com page

get_api_reference

Look up API reference for a specific class by fully-qualified name.

Parameter	Type	Default	Description
class_name	string	(required)	FQCN (e.g., android.app.Activity)
language	"java" | "kotlin"	auto	Defaults to kotlin for AndroidX, java for platform

list_android_packages

List available packages from the official package index.

Parameter	Type	Default	Description
type	"platform" | "androidx"	"androidx"	Package set
language	"java" | "kotlin"	"java"	Doc language
filter	string	—	Substring filter (e.g., "compose")

get_release_notes

Fetch Jetpack library release notes.

Parameter	Type	Default	Description
library	string	(required)	Library name (e.g., compose, lifecycle)
version	string	—	Filter to a specific version
max_entries	number	5	Max entries (1–50)

Configuration

Environment Variable	Default	Description
CACHE_TTL_MS	86400000 (24h)	Cache time-to-live in milliseconds

Architecture

src/
├── index.ts              # MCP server entrypoint
├── lib/
│   ├── cache.ts          # In-memory LRU cache (500 entries, 24h TTL)
│   ├── fetcher.ts        # HTTP fetch with retry + cache integration
│   ├── parser.ts         # HTML → Markdown (cheerio + turndown)
│   └── url-resolver.ts   # FQCN → URL mapping
└── tools/
    ├── search.ts         # search_android_docs
    ├── get-doc.ts        # get_android_doc_page
    ├── get-api-reference.ts  # get_api_reference
    ├── list-packages.ts  # list_android_packages
    └── get-release-notes.ts  # get_release_notes

Disclaimer

This tool fetches content from developer.android.com on demand at runtime. The documentation content is owned by Google and licensed under the Creative Commons Attribution 2.5 License, and code samples are licensed under the Apache 2.0 License. This project is not affiliated with or endorsed by Google.

License

Apache 2.0 — see LICENSE for details.