fullread avatar

Deepadb

fullread/deepadb

The most comprehensive ADB integration available for AI agents, giving Claude direct access to connected Android devices through 204 tools across 45 modules. Install apps, pull logs, capture screens, analyze UI hierarchies, run test sessions, inspect baseband firmware, monitor OTA updates, audit SELinux policies, and orchestrate multi-device operations. Runs in two modes: standard PC-side over USB, or directly inside Termux on the device itself with automatic root elevation for privileged commands. The on-device mode is particularly clever, auto-detecting the Android environment and switching to local shell execution with zero ADB overhead. Ships with triple transport support (stdio, HTTP/SSE, WebSocket), optional GraphQL API, and 613 tests validated on real hardware. Reach for this when you need programmatic Android control beyond basic shell commands.

GitHub stars
20
tools
80
transport
STDIO
last updated
Nov 1, 2026

Tools

80 tools

Public tool metadata for what this MCP can expose to an agent.

adb_health_checkComprehensive toolchain validation: ADB binary, server, device connection, authorization, root access, and storage writability

Comprehensive toolchain validation: ADB binary, server, device connection, authorization, root access, and storage writability

No parameter schema in public metadata yet.

adb_runtime_auditUnified read-only readiness audit for transport, Android userspace, root, SELinux, storage, command capabilities, UI/network diagnostics, SQLite, modem nodes, and Wear prerequisites

Unified read-only readiness audit for transport, Android userspace, root, SELinux, storage, command capabilities, UI/network diagnostics, SQLite, modem nodes, and Wear prerequisites

No parameter schema in public metadata yet.

adb_devicesList all connected devices with state, model, and product info

List all connected devices with state, model, and product info

No parameter schema in public metadata yet.

adb_device_infoDetailed device properties (model, OS, SDK, build, security patch, ABI)

Detailed device properties (model, OS, SDK, build, security patch, ABI)

No parameter schema in public metadata yet.

adb_getpropRead a specific system property or dump all properties

Read a specific system property or dump all properties

No parameter schema in public metadata yet.

adb_shellExecute arbitrary shell commands with configurable timeout (security-checked)

Execute arbitrary shell commands with configurable timeout (security-checked)

No parameter schema in public metadata yet.

adb_root_shellExecute commands as root via su (requires rooted device, security-checked)

Execute commands as root via su (requires rooted device, security-checked)

No parameter schema in public metadata yet.

adb_installInstall APK with replace/downgrade options

Install APK with replace/downgrade options

No parameter schema in public metadata yet.

adb_uninstallRemove package with optional data retention

Remove package with optional data retention

No parameter schema in public metadata yet.

adb_list_packagesList packages filtered by name or type (all/system/third-party)

List packages filtered by name or type (all/system/third-party)

No parameter schema in public metadata yet.

adb_package_infoDetailed package info (version, permissions, paths)

Detailed package info (version, permissions, paths)

No parameter schema in public metadata yet.

adb_clear_dataClear all app data and cache

Clear all app data and cache

No parameter schema in public metadata yet.

adb_grant_permissionGrant a runtime permission to a package

Grant a runtime permission to a package

No parameter schema in public metadata yet.

adb_revoke_permissionRevoke a runtime permission from a package (reset permission state for testing denial flows)

Revoke a runtime permission from a package (reset permission state for testing denial flows)

No parameter schema in public metadata yet.

adb_list_permissionsList all declared and granted permissions for a package, filterable by granted/denied

List all declared and granted permissions for a package, filterable by granted/denied

No parameter schema in public metadata yet.

adb_force_stopForce-stop an app immediately

Force-stop an app immediately

No parameter schema in public metadata yet.

adb_start_appLaunch an app by package name (resolves launcher activity)

Launch an app by package name (resolves launcher activity)

No parameter schema in public metadata yet.

adb_restart_appForce-stop then re-launch in one call (configurable delay)

Force-stop then re-launch in one call (configurable delay)

No parameter schema in public metadata yet.

adb_resolve_intentsDiscover registered activities, services, and receivers with intent filters

Discover registered activities, services, and receivers with intent filters

No parameter schema in public metadata yet.

adb_sqlite_inspectPackage-scoped listing, schema inspection and validated read-only SQL. Prefers run-as, falls back to root, rejects linked directories/files and verifies opened descriptors

Package-scoped listing, schema inspection and validated read-only SQL. Prefers run-as, falls back to root, rejects linked directories/files and verifies opened descriptors

No parameter schema in public metadata yet.

adb_pushPush local file to device (hard-blocked kernel paths, fs-type awareness, storage reporting)

Push local file to device (hard-blocked kernel paths, fs-type awareness, storage reporting)

No parameter schema in public metadata yet.

adb_pullPull file from device to local filesystem

Pull file from device to local filesystem

No parameter schema in public metadata yet.

adb_lsList device directory contents (simple or detailed)

List device directory contents (simple or detailed)

No parameter schema in public metadata yet.

adb_catRead text file from device with optional line limit

Read text file from device with optional line limit

No parameter schema in public metadata yet.

adb_file_writeCreate or overwrite text files via heredoc (buffer limit warning, fs-aware, post-verify)

Create or overwrite text files via heredoc (buffer limit warning, fs-aware, post-verify)

No parameter schema in public metadata yet.

adb_findSearch for files by name/pattern with depth control and result capping

Search for files by name/pattern with depth control and result capping

No parameter schema in public metadata yet.

adb_file_statFile metadata: size, permissions, timestamps, ownership, SELinux context

File metadata: size, permissions, timestamps, ownership, SELinux context

No parameter schema in public metadata yet.

adb_file_checksumSHA-256/SHA-1/MD5 hash with size-based timeout estimation

SHA-256/SHA-1/MD5 hash with size-based timeout estimation

No parameter schema in public metadata yet.

adb_mkdirCreate directories with parent creation (-p), hard-blocked kernel paths

Create directories with parent creation (-p), hard-blocked kernel paths

No parameter schema in public metadata yet.

adb_rmDelete files/directories with depth-based recursive protection and symlink resolution

Delete files/directories with depth-based recursive protection and symlink resolution

No parameter schema in public metadata yet.

adb_file_moveMove/rename with source depth protection and post-verify

Move/rename with source depth protection and post-verify

No parameter schema in public metadata yet.

adb_file_copyCopy with pre-flight size+space check and post-verify size match

Copy with pre-flight size+space check and post-verify size match

No parameter schema in public metadata yet.

adb_file_chmodChange permissions (Zod-validated octal mode, depth-based recursive protection)

Change permissions (Zod-validated octal mode, depth-based recursive protection)

No parameter schema in public metadata yet.

adb_file_touchCreate empty files or update timestamps (explicit timestamp support)

Create empty files or update timestamps (explicit timestamp support)

No parameter schema in public metadata yet.

adb_file_fsinfoFilesystem report: type, mount, capacity, capabilities, SELinux, limitations

Filesystem report: type, mount, capacity, capabilities, SELinux, limitations

No parameter schema in public metadata yet.

adb_file_chownChange ownership (root required, depth-based recursive protection)

Change ownership (root required, depth-based recursive protection)

No parameter schema in public metadata yet.

adb_grepSearch file contents with fixed-string default, recursive depth control, result capping

Search file contents with fixed-string default, recursive depth control, result capping

No parameter schema in public metadata yet.

adb_file_replaceFind/replace text in files (sed-backed, proper escaping, backup option)

Find/replace text in files (sed-backed, proper escaping, backup option)

No parameter schema in public metadata yet.

adb_logcatFiltered logcat snapshot with tag, priority, grep, and buffer selection

Filtered logcat snapshot with tag, priority, grep, and buffer selection

No parameter schema in public metadata yet.

adb_logcat_clearClear all logcat buffers

Clear all logcat buffers

No parameter schema in public metadata yet.

adb_logcat_crashCrash buffer log snapshot

Crash buffer log snapshot

No parameter schema in public metadata yet.

adb_logcat_startStart a background logcat watcher with ring buffer accumulation

Start a background logcat watcher with ring buffer accumulation

No parameter schema in public metadata yet.

adb_logcat_pollRetrieve new lines since last poll from a running watcher

Retrieve new lines since last poll from a running watcher

No parameter schema in public metadata yet.

adb_logcat_stopStop a watcher session (or all sessions)

Stop a watcher session (or all sessions)

No parameter schema in public metadata yet.

adb_logcat_sessionsList all active watcher sessions with stats

List all active watcher sessions with stats

No parameter schema in public metadata yet.

adb_dumpsysRun dumpsys for any service (or list all services)

Run dumpsys for any service (or list all services)

No parameter schema in public metadata yet.

adb_telephonyCell info, signal strength, and network registration (parallel query)

Cell info, signal strength, and network registration (parallel query)

No parameter schema in public metadata yet.

adb_batteryBattery status, level, temperature, and charging info

Battery status, level, temperature, and charging info

No parameter schema in public metadata yet.

adb_networkWiFi, cellular, and IP connectivity (parallel query)

WiFi, cellular, and IP connectivity (parallel query)

No parameter schema in public metadata yet.

adb_topCPU and memory usage snapshot

CPU and memory usage snapshot

No parameter schema in public metadata yet.

adb_perf_snapshotParallel memory, frame stats, and CPU profiling for a package

Parallel memory, frame stats, and CPU profiling for a package

No parameter schema in public metadata yet.

adb_bugreportFull bug report zip capture (device state, logs, system info)

Full bug report zip capture (device state, logs, system info)

No parameter schema in public metadata yet.

adb_crash_logsANR traces and tombstone crash dumps from /data/anr/ and /data/tombstones/

ANR traces and tombstone crash dumps from /data/anr/ and /data/tombstones/

No parameter schema in public metadata yet.

adb_heap_dumpCapture heap dump (.hprof) from a running process for memory analysis

Capture heap dump (.hprof) from a running process for memory analysis

No parameter schema in public metadata yet.

adb_app_route_contextResolve an installed package to its UID and correlate effective ip rule ranges, route tables, network policy, VPN, and default-network state without changing routes or policy

Resolve an installed package to its UID and correlate effective ip rule ranges, route tables, network policy, VPN, and default-network state without changing routes or policy

No parameter schema in public metadata yet.

adb_screencapTake screenshot with filename sanitization, saves locally

Take screenshot with filename sanitization, saves locally

No parameter schema in public metadata yet.

adb_screencap_annotatedScreenshot with UI element bounding boxes and numbered labels composited onto the PNG, plus a text legend

Screenshot with UI element bounding boxes and numbered labels composited onto the PNG, plus a text legend

No parameter schema in public metadata yet.

adb_current_activityGet focused activity and top window stack

Get focused activity and top window stack

No parameter schema in public metadata yet.

adb_inputSend tap, swipe, text, or keyevent input

Send tap, swipe, text, or keyevent input

No parameter schema in public metadata yet.

adb_start_activityLaunch activities by intent or component name

Launch activities by intent or component name

No parameter schema in public metadata yet.

adb_ui_dumpDump full UI hierarchy in text, tsv, or xml format

Dump full UI hierarchy in text, tsv, or xml format

No parameter schema in public metadata yet.

adb_ui_findSearch UI hierarchy by text, resource-id, or content-description (returns tap coordinates)

Search UI hierarchy by text, resource-id, or content-description (returns tap coordinates)

No parameter schema in public metadata yet.

adb_screen_stateCombined screen state in one call: foreground activity, screen dimensions and density, orientation, battery level, and a TSV list of interactive elements

Combined screen state in one call: foreground activity, screen dimensions and density, orientation, battery level, and a TSV list of interactive elements

No parameter schema in public metadata yet.

adb_screenrecord_startStart recording the device screen (1-180s, stored on device)

Start recording the device screen (1-180s, stored on device)

No parameter schema in public metadata yet.

adb_screenrecord_stopStop recording and pull the mp4 video file locally

Stop recording and pull the mp4 video file locally

No parameter schema in public metadata yet.

adb_airplane_modeToggle airplane mode with broadcast and verification

Toggle airplane mode with broadcast and verification

No parameter schema in public metadata yet.

adb_airplane_cycleCycle airplane mode on/off to force cellular re-registration

Cycle airplane mode on/off to force cellular re-registration

No parameter schema in public metadata yet.

adb_wifiEnable or disable WiFi

Enable or disable WiFi

No parameter schema in public metadata yet.

adb_mobile_dataEnable or disable mobile data

Enable or disable mobile data

No parameter schema in public metadata yet.

adb_locationSet location mode (off/sensors/battery/high)

Set location mode (off/sensors/battery/high)

No parameter schema in public metadata yet.

adb_screenWake, sleep, toggle, lock, or unlock the screen, with optional PIN entry sequence

Wake, sleep, toggle, lock, or unlock the screen, with optional PIN entry sequence

No parameter schema in public metadata yet.

adb_settings_getRead any Android setting from system/secure/global namespace

Read any Android setting from system/secure/global namespace

No parameter schema in public metadata yet.

adb_settings_putWrite any Android setting with read-back verification

Write any Android setting with read-back verification

No parameter schema in public metadata yet.

adb_rebootReboot device (normal, recovery, or bootloader mode)

Reboot device (normal, recovery, or bootloader mode)

No parameter schema in public metadata yet.

adb_pairPair with device over WiFi using pairing code

Pair with device over WiFi using pairing code

No parameter schema in public metadata yet.

adb_connectConnect to device over WiFi/TCP

Connect to device over WiFi/TCP

No parameter schema in public metadata yet.

adb_disconnectDisconnect wireless device(s)

Disconnect wireless device(s)

No parameter schema in public metadata yet.

adb_tcpipSwitch USB device to TCP/IP mode (auto-detects device IP)

Switch USB device to TCP/IP mode (auto-detects device IP)

No parameter schema in public metadata yet.

adb_forwardForward a local port to a device port (host → device)

Forward a local port to a device port (host → device)

No parameter schema in public metadata yet.

adb_reverseReverse-forward a device port to the host (device → host)

Reverse-forward a device port to the host (device → host)

No parameter schema in public metadata yet.

Sponsors

Readme

DeepADB

Build npm License Official MCP Registry

MCP (Model Context Protocol) server for AI agents that need to inspect, control, test, and diagnose Android devices through ADB—or directly on-device through Termux.

209 tools, 5 resources, and 4 prompts across 49 modules—from UI automation and application management to logs, network capture, baseband, firmware, security, and hardware diagnostics.

Get started

DeepADB runs as a local MCP server. It uses ADB on a host computer and automatically switches to direct execution when running on Android (detected through /system/build.prop).

git clone https://github.com/fullread/DeepADB.git
cd DeepADB
npm ci
npm run build
npm start

View the full README on GitHub

Details

Repository
github.com/fullread/deepadb
Website
github.com/fullread/DeepADB
Category
Mobile Development
Package
deepadb
Transport
STDIO
Registry
MCP registry, active

Related Mobile Development MCP servers

View all
1thecombatwombat avatarreplicant-mcpthecombatwombat/replicant-mcpAndroid MCP server for AI-assisted development. Build, test, emulate, and automate.13stars
2carloshpdoc avatarMemorydetectivecarloshpdoc/memorydetectiveiOS leak/perf debugging via MCP: memgraph cycles, .trace analysis, SourceKit-LSP bridging.11stars
3silbercue avatarSilbercueSwift — iOS MCP Serversilbercue/silbercueswiftiOS MCP server: 49 tools free (58 with Pro), xcresult parsing, WDA UI automation, fast screenshots.9stars
4kivanccakmak avatarYaverkivanccakmak/yaver.ioPhone-first local dev MCP for Claude Code and Codex: install Yaver, pair mobile, run, build, deploy.5stars
5silbercue avatarSilbercueSwiftsilbercue/silbercueswiftFastest iOS MCP server. 40 tools: xcresult parsing, WDA automation, 0.3s screenshots.5stars
6zyntx-lab avatarPeriphery Code Auditzyntx-lab/periphery-mcp-serverSwift code analysis with Periphery - detect unused code and improve code quality2stars