adb_grep
Search file contents on Android devices by text pattern using fixed-string matching. Supports recursive directory search with depth control and result limits.
Instructions
Search file contents on the device by text pattern. Uses fixed-string matching by default (no regex injection risk). Supports recursive directory search with depth control and result capping. For filename searches, use adb_find instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pattern | Yes | Text pattern to search for | |
| path | Yes | File or directory path to search | |
| recursive | No | Search directories recursively | |
| fixedString | No | Use fixed-string matching (default: true, safer). Set false for regex. | |
| ignoreCase | No | Case-insensitive search (default: true) | |
| maxResults | No | Maximum matching lines to return (1-10000, default 500) | |
| maxDepth | No | Maximum directory depth for recursive search (1-50, default 10) | |
| filesWithMatches | No | Show only filenames that contain matches, not the matching lines | |
| root | No | Use root shell for protected paths | |
| device | No | Device serial | |
| result_handle | No | Optional. If provided, store this tool's result under `result://<tool>/<name>` for retrieval after compaction. Name must be 1-32 chars, [a-zA-Z0-9_-]. Existing handles with the same tool+name are overwritten. Use adb_result_list to see active handles, adb_result_get or the MCP Resource URI to retrieve. | |
| result_handle_ttl | No | Optional. TTL in seconds for the result handle (60 to 604800). Default 43200 (12 hours). Ignored if result_handle is not provided. |