app_notifications

This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET

Read the notification shade, post a notification to it, or open it. Reading is how you assert an app posted what it should. Posting is an interruption arriving from elsewhere, and is confirmed by reading the shade back — cmd notification post prints what it thinks it built and says nothing about whether the system accepted it. Opening the shade is what makes a notification tappable: until then it is not on screen and app_map cannot see it. Opening or closing the shade discards the refs from the last app_map, since it covers the app.

Changes the device, the app or the session: readOnlyHint is false.

Arguments

Name	Type	Required	What it is
device	string		Device serial to target, e.g. "emulator-5554". Omit when only one device is running.
driver	string: uiautomator2, uiautomator, wda		Driver to use: "uiautomator2" (default for Android; fast, installs a server APK on first use), "uiautomator" (Android, installs nothing, slower, cannot type), or "wda" (WebDriverAgent: iOS simulators and iPhones).
shade	string: open, close		"open" to pull the shade down so notifications can be tapped, "close" to dismiss it.
tag	string		Tag identifying the posted notification. Defaults to "mobium".
text	string		Body of a notification to post. Omit to only read.
title	string		Title of the notification to post. Defaults to "Mobium".

Examples

Each is the arguments of a tools/call request; the first is shown whole.

Post a notification

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "app_notifications",
    "arguments": {
      "text": "Your code is 123456"
    }
  }
}

On an Android 15 emulator the answer's text was:

android  Serial console enabled — Performance is impacted. To disable, check bootloader.
com.android.shell  Mobium — Your code is 123456

Pull the shade down

{
  "shade": "open"
}

On an Android 15 emulator the answer's text was:

com.android.shell  Mobium — Your code is 123456
android  Serial console enabled — Performance is impacted. To disable, check bootloader.

mobium notifications --shade open on an Android 15 emulator