android-app

Manage Android apps with actions like install, uninstall, start, stop, clear data, and retrieve app details. Supports package-specific operations via a unified interface for streamlined application control and analysis.

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. include_system_apps (Optional[bool]): Whether to include system apps. 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_path
- Optional: reinstall, grant_permissions
action="uninstall_app"
- Requires: package
- Optional: keep_data
action="start_app"
- Requires: package
- Optional: activity
action="stop_app"
- Requires: package
action="clear_app_data"
- Requires: package
action="list_packages"
- Optional: include_system_apps
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
`action`	Yes
`activity`	No
`apk_path`	No
`grant_permissions`	No
`include_system_apps`	No
`keep_data`	No
`package`	No
`reinstall`	No
`serial`	Yes

Input Schema (JSON Schema)

{
  "$defs": {
    "AppAction": {
      "description": "Defines the available sub-actions for the 'android-app' tool.",
      "enum": [
        "install_app",
        "uninstall_app",
        "start_app",
        "stop_app",
        "clear_app_data",
        "list_packages",
        "get_app_manifest",
        "get_app_permissions",
        "get_app_activities",
        "get_app_info"
      ],
      "title": "AppAction",
      "type": "string"
    }
  },
  "properties": {
    "action": {
      "$ref": "#/$defs/AppAction"
    },
    "activity": {
      "default": "",
      "title": "Activity",
      "type": "string"
    },
    "apk_path": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Apk Path"
    },
    "grant_permissions": {
      "default": true,
      "title": "Grant Permissions",
      "type": "boolean"
    },
    "include_system_apps": {
      "default": false,
      "title": "Include System Apps",
      "type": "boolean"
    },
    "keep_data": {
      "default": false,
      "title": "Keep Data",
      "type": "boolean"
    },
    "package": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Package"
    },
    "reinstall": {
      "default": false,
      "title": "Reinstall",
      "type": "boolean"
    },
    "serial": {
      "title": "Serial",
      "type": "string"
    }
  },
  "required": [
    "serial",
    "action"
  ],
  "title": "app_operationsArguments",
  "type": "object"
}

DroidMind

android-app

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from DroidMind

Related Tools

MCP directory API