LinuxCommandLibrary

mmcli

TLDR

List available modems

$ mmcli --list-modems
copy
Print information about a modem
$ mmcli --modem=[modem_id]
copy
Enable a modem
$ mmcli --modem=[modem_id] --enable
copy
Disable a modem
$ mmcli --modem=[modem_id] --disable
copy
List SMS messages on the modem
$ sudo mmcli --modem=[modem_id] --messaging-list-sms
copy
Delete SMS message
$ sudo mmcli --modem=[modem_id] --messaging-delete-sms=[sms_path]
copy
Monitor modem status changes
$ mmcli --monitor-modems
copy

SYNOPSIS

mmcli [--list-modems] [--modem id] [--enable|--disable] [--messaging-list-sms] [options]

DESCRIPTION

mmcli is a command-line interface for ModemManager, a DBus-powered daemon that provides unified control of mobile broadband modems on Linux. It supports various modem types including USB modems, embedded cellular modules, and phone tethering.
The tool can enable/disable modems, manage connections, send/receive SMS, control GPS functionality, scan for networks, and perform SIM operations. It communicates with ModemManager through DBus.

PARAMETERS

-L, --list-modems

List all available modems
-m, --modem _id_
Specify modem by index or DBus path
-M, --monitor-modems
Monitor modem status changes
-e, --enable
Enable the specified modem
-d, --disable
Disable the specified modem
-r, --reset
Reset the modem
--factory-reset _code_
Reset modem to factory state with unlock code
--command _at_command_
Send raw AT command to modem
--messaging-list-sms
List SMS messages on modem
--messaging-create-sms _properties_
Create new SMS message
--messaging-delete-sms _sms_
Delete SMS message
-S, --scan-modems
Scan for new modems
--output-json
Output in JSON format
--output-keyvalue
Output as key-value pairs
-v, --verbose
Enable verbose output

CAVEATS

Some operations require root privileges, particularly SMS and connection management. Modem indices may change across reboots or device reconnections; use DBus paths for stable identification. Factory reset requires carrier-specific unlock codes and erases all modem configuration.

HISTORY

mmcli is part of ModemManager, developed by the freedesktop.org community. ModemManager provides a unified high-level API for mobile broadband modems, abstracting differences between vendor implementations. It is commonly used with NetworkManager for mobile connectivity.

SEE ALSO

> TERMINAL_GEAR

Curated for the Linux community

KIWITATA 2X Classic SNES USB Controller for PC Gamings, Retro SNES Wired USB Game Emulator Controller for Windows XP 7 8 11 Mac Raspberry Pi

KIWITATA 2X Classic SNES USB Controller for PC Gamings, Retro SNES Wired USB Game Emulator Controller for Windows XP 7 8 11 Mac Raspberry Pi

$16.99
Raspberry Pi 5 8GB

Raspberry Pi 5 8GB

$134.50
Bmax Mini PC B2 Power Intel 5205U 8GB DDR4 256GB M.2 NVMe SSD ,HDMI 1.4&DP 1.2, USB3.2,4K Dual Display 2.4G/5G WiFi & BT5.0 Mini Desktop Computers /Office/Design

Bmax Mini PC B2 Power Intel 5205U 8GB DDR4 256GB M.2 NVMe SSD ,HDMI 1.4&DP 1.2, USB3.2,4K Dual Display 2.4G/5G WiFi & BT5.0 Mini Desktop Computers /Office/Design

$169.99
Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community

GMKtec Gaming PC, K11 AMD Ryzen 9 8945HS, 32GB DDR5 RAM 1TB Mini PC Desktop Computer, Oculink, Dual NIC 2.5GbE LAN, HDMI/DisplayPort/USB4*2

GMKtec Gaming PC, K11 AMD Ryzen 9 8945HS, 32GB DDR5 RAM 1TB Mini PC Desktop Computer, Oculink, Dual NIC 2.5GbE LAN, HDMI/DisplayPort/USB4*2

$739.99
Lenovo Gen 13 ThinkPad X1 Carbon Touchscreen Laptop with Intel Ultra 7 265U Processor, 14" WUXGA 100% sRGB, 32GB DDR5 RAM, 1TB NVMe Performance SSD, FHD+ IR+ RGB Camera, and Windows 11 Pro

Lenovo Gen 13 ThinkPad X1 Carbon Touchscreen Laptop with Intel Ultra 7 265U Processor, 14" WUXGA 100% sRGB, 32GB DDR5 RAM, 1TB NVMe Performance SSD, FHD+ IR+ RGB Camera, and Windows 11 Pro

$1,589.00
New Raspberry Pi 3 Model B+ Board Raspberry PI 3B+

New Raspberry Pi 3 Model B+ Board Raspberry PI 3B+

$54.00