@dougschaefer/eero-network

Eero mesh WiFi management via cloud API — network health, per-node status, per-client band/signal/channel diagnostics, speed tests, settings management, and raw API passthrough. Reverse-engineered from the eero mobile app API.

Repository

https://github.com/dougschaefer6/swamp-eero

Platforms

linux-x86_64 linux-aarch64 darwin-x86_64 darwin-aarch64

Labels

eerowifimeshnetworkingdiagnostics

Install

$ swamp extension pull @dougschaefer/eero-network

Release Notes

v2: 26 methods — added full-diagnostic, connections/LLDP, routing, transfer, DHCP reservations, DNS policies, Thread, guest network, device management, blacklist, firmware updates, WiFi password, hide-5GHz toggle. Fixed session token logging (no longer in plaintext).

@dougschaefer/eero-networkv2026.04.04.1eero/network.ts

apiRaw eero API call — hit any endpoint directly. Path is relative to /2.2/ (e.g., 'account').

Argument	Type	Required	Description
path	string	yes	API path after version prefix (e.g., 'account', 'networks/12345/devices')
method	enum	yes
body?	record	no
apiVersion	string	yes	API version (default 2.2, some endpoints use 2.3)

networkGet eero network overview — health, settings, speed test results, topology summary.

eerosList all eero nodes — model, firmware, status, gateway flag, connected client count.

clientsList all connected clients with band (2.4/5 GHz), signal strength, channel, which eero node they're on, and connection type. This is the primary diagnostic method for WiFi performance issues.

Argument	Type	Required	Description
connectedOnly	boolean	yes	Only show currently connected clients (default: true)

settingsGet or update eero network settings — DNS, IPv6, SQM, WPA3, UPnP, band steering.

Argument	Type	Required	Description
updates?	record	no	Settings to update as key-value pairs (e.g., {"band_steering": true, "ipv6_upstream": true}). Omit to just read.

connectionsGet per-node port details, wiring topology, LLDP neighbors, and negotiated speeds.

routingGet eero network routing table.

transferGet network-wide data transfer statistics.

reservationsList DHCP reservations.

threadGet Thread smart home mesh network status — channel, credentials, border agents.

updatesGet firmware update status, target version, and trigger updates.

Argument	Type	Required	Description
trigger	boolean	yes	Set true to trigger a firmware update. False just checks status.

diagnosticsRun or retrieve eero network diagnostics — connectivity checks, node health.

Argument	Type	Required	Description
trigger	boolean	yes	Set true to trigger a new diagnostic run.

blacklistList blocked devices or block/unblock a device by MAC.

Argument	Type	Required	Description
action	enum	yes
mac?	string	no	Device MAC for block/unblock actions

Resources

auth-state(1h)— Authentication state — user token for verification step

api-response(1h)— Raw API response from any eero endpoint

network(1h)— Eero network overview — health, settings, speed, topology

eero(1h)— Eero node — model, status, gateway flag, connected clients, firmware

client(1h)— Connected client — band, signal strength, channel, eero node, IPs

Repository

Platforms

Labels

Contents

Install

Release Notes

Models1

Resources

Previous Versions1

Release Notes