android-app
Perform Android app management: install, uninstall, start, stop, clear data, list packages, and retrieve app manifest, permissions, activities, and info.
Instructions
Perform various application management operations on an Android device.
This single tool consolidates various app-related actions. The 'action' parameter determines the operation.
Args:
serial: Device serial number.
action: The specific app operation to perform.
ctx: MCP Context for logging and interaction.
package (Optional[str]): Package name for the target application. Required by most actions.
apk_path (Optional[str]): Path to the APK file (local to the server). Used by install_app.
reinstall (Optional[bool]): Whether to reinstall if app exists. Used by install_app.
grant_permissions (Optional[bool]): Whether to grant all requested permissions. Used by install_app.
keep_data (Optional[bool]): Whether to keep app data and cache directories. Used by uninstall_app.
activity (Optional[str]): Optional activity name to start. Used by start_app.
extras (Optional[dict[str, str]]): Optional intent extras. Used by start_intent.
include_system_apps (Optional[bool]): Whether to include system apps. Used by list_packages.
include_app_name (Optional[bool]): Whether to include app labels (best-effort). Used by list_packages.
include_apk_path (Optional[bool]): Whether to include APK paths. Used by list_packages.
max_packages (Optional[int]): Max packages to return. Used by list_packages.
Returns: A string message indicating the result or status of the operation.
Available Actions and their specific argument usage:
action="install_app"Requires:
apk_pathOptional:
reinstall,grant_permissions
action="uninstall_app"Requires:
packageOptional:
keep_data
action="start_app"Requires:
packageOptional:
activity3b.action="start_intent"Requires:
package,activityOptional:
extras
action="stop_app"Requires:
package
action="clear_app_data"Requires:
package
action="list_packages"Optional:
include_system_apps,include_app_name,include_apk_path,max_packages
action="get_app_manifest"Requires:
package
action="get_app_permissions"Requires:
package
action="get_app_activities"Requires:
package
action="get_app_info"Requires:
package
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| serial | Yes | ||
| action | Yes | ||
| package | No | ||
| apk_path | No | ||
| reinstall | No | ||
| grant_permissions | No | ||
| keep_data | No | ||
| activity | No | ||
| extras | No | ||
| include_system_apps | No | ||
| include_app_name | No | ||
| include_apk_path | No | ||
| max_packages | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |