Hardpoint

Devices / Mouse / Logitech

Logitech MX Master 3

Wireless mouse with a thumb wheel, a gesture button and three host slots.

logitech/mx-master-3 · Model match: A named public model or model identifier; this does not verify every configuration or operation.

What it can do

AbilityLabelChecked
Firmware version or layout identifier the device reports.identity.firmware
Details
Checked on
macos 27.2 · 2026-11-15
What was checked
Read through the adapter.
Route
macos-system source=bluetooth field=firmware_version (implemented)
Value
reading, string
readtested commit
Put it on my keyboard when this is about to die.battery.level
Details
Checked on
macos 27.2 · 2026-11-15
What was checked
Read through the adapter, over Bluetooth.
Note
This model answers on the older battery feature (0x1000), not the unified one (0x1004). macOS does not report this mouse's battery itself.
Route
hidpp feature=1000 (implemented)
Value
reading, percent
readtested commit
Slow the pointer right down while I draw this.pointer.dpi
Details
Checked on
macos 27.2 · 2026-11-15
What was checked
Read; then raised through the gatekeeper, which put it back by itself when nobody kept it.
Note
Other open tools document a 4000 DPI ceiling for this model.
If done carelessly
A pointer that is suddenly far too fast or too slow can be too hard to steer to undo it.
Route
hidpp feature=2201 (implemented)
Value
control, dots per inch
guardedtested commit
Make the side button mute my microphone.pointer.buttons
Details
Checked on
macos 27.2 HID++ 4.5 · 2026-11-13
What was checked
The mouse reports eight reprogrammable controls. Redirecting one was not exercised.
Note
The thumb and gesture buttons can be handed to software.
If done carelessly
A button stops doing what your hand expects, and it may be the one you would undo it with.
Route
hidpp feature=1b04 (implemented)
Value
control, button to software
guardedobserved commit
Let the wheel spin freely while I read this long file.scroll.mode
Details
Checked on
macos 27.2 · 2026-11-15
What was checked
Read, changed and put back through the gatekeeper.
Route
hidpp feature=2110 (implemented)
Value
control, ratchet or free-spin
reversibletested commit
Move the device to another paired computer.pointer.host
Details
Checked on
macos 27.2 HID++ 4.5 · 2026-11-13
What was checked
Three host slots and the current slot were read. Switching was not exercised.
Note
Moves the mouse to another paired computer, so the computer that sent the change loses it.
If done carelessly
The device leaves this computer, and nothing here can reach it to bring it back.
Route
hidpp feature=1814 (implemented)
Value
control, host number
gatedobserved commit

Before it will work

PlatformNeeds
macosInput Monitoring permission for the program that opens the deviceWithout it the control channel refuses to open ("not permitted"). With it, the channel opened. Checked both ways on macOS 27.2.

How it is recognised

BusIdentifiers
bluetoothvendor_id=046d product_id=b023

Sources

In a standard form

The same card as a W3C Web of Things Thing Model, for tools that read that standard. Hardpoint's added terms.

The card

This page is made from catalog/devices/logitech/mx-master-3.toml. If something is wrong, or you have checked more of it, edit that file.

card = 1

[device]
id = "logitech/mx-master-3"
vendor = "Logitech"
name = "MX Master 3"
identity = "model"
aliases = ["MX Master 3 Advanced Wireless Mouse"]
kind = "mouse"
summary = "Wireless mouse with a thumb wheel, a gesture button and three host slots."
links = ["https://ir.logitech.com/news/news-details/2019/Logitech-Enables-Advanced-Users-to-Achieve-Peak-Performance-with-MX-Master-3-and-MX-Keys"]

[[sources]]
title = "Logitech: MX Master 3 product announcement and model features"
url = "https://ir.logitech.com/news/news-details/2019/Logitech-Enables-Advanced-Users-to-Achieve-Peak-Performance-with-MX-Master-3-and-MX-Keys"

[[match]]
bus = "bluetooth"
vendor_id = 0x046d
product_id = 0xb023

[[requires]]
platform = "macos"
what = "Input Monitoring permission for the program that opens the device"
note = "Without it the control channel refuses to open (\"not permitted\"). With it, the channel opened. Checked both ways on macOS 27.2."

[[capability]]
id = "identity.firmware"
adapter = "macos-system"
risk = "read"
params = { source = "bluetooth", field = "firmware_version" }
verification = [{ status = "tested", platform = "macos", os = "27.2", date = 2026-11-15, note = "Read through the adapter." }, { status = "observed", platform = "macos", os = "27.2", date = 2026-11-13, note = "macOS reports a firmware version for this mouse. Not read through an adapter yet." }]

[[capability]]
id = "battery.level"
adapter = "hidpp"
risk = "read"
params = { feature = 0x1000 }
note = "This model answers on the older battery feature (0x1000), not the unified one (0x1004). macOS does not report this mouse's battery itself."
verification = [{ status = "tested", platform = "macos", os = "27.2", date = 2026-11-15, note = "Read through the adapter, over Bluetooth." }, { status = "observed", platform = "macos", os = "27.2", firmware = "HID++ 4.5", date = 2026-11-13, note = "A charge level was read with a one-off HID++ query. The adapter is not written yet." }]

[[capability]]
id = "pointer.dpi"
adapter = "hidpp"
risk = "guarded"
params = { feature = 0x2201 }
note = "Other open tools document a 4000 DPI ceiling for this model."
verification = [{ status = "tested", platform = "macos", os = "27.2", date = 2026-11-15, note = "Read; then raised through the gatekeeper, which put it back by itself when nobody kept it." }, { status = "observed", platform = "macos", os = "27.2", firmware = "HID++ 4.5", date = 2026-11-13, note = "The current and default values were read (both 1000). Setting it was not exercised." }]

[[capability]]
id = "pointer.buttons"
adapter = "hidpp"
risk = "guarded"
params = { feature = 0x1b04 }
note = "The thumb and gesture buttons can be handed to software."
verification = [{ status = "observed", platform = "macos", os = "27.2", firmware = "HID++ 4.5", date = 2026-11-13, note = "The mouse reports eight reprogrammable controls. Redirecting one was not exercised." }]

[[capability]]
id = "scroll.mode"
adapter = "hidpp"
risk = "reversible"
params = { feature = 0x2110 }
verification = [{ status = "tested", platform = "macos", os = "27.2", date = 2026-11-15, note = "Read, changed and put back through the gatekeeper." }, { status = "observed", platform = "macos", os = "27.2", firmware = "HID++ 4.5", date = 2026-11-13, note = "The current mode was read with a one-off query. Changing it was not exercised." }]

[[capability]]
id = "pointer.host"
adapter = "hidpp"
risk = "gated"
params = { feature = 0x1814 }
note = "Moves the mouse to another paired computer, so the computer that sent the change loses it."
verification = [{ status = "observed", platform = "macos", os = "27.2", firmware = "HID++ 4.5", date = 2026-11-13, note = "Three host slots and the current slot were read. Switching was not exercised." }]

[[sources]]
title = "Solaar capabilities"
url = "https://pwr-solaar.github.io/Solaar/capabilities/"

[[sources]]
title = "ArchWiki: Logitech MX Master"
url = "https://wiki.archlinux.org/title/Logitech_MX_Master"

[[sources]]
title = "OpenLogi"
url = "https://openlogi.org/"