Skip to main content

@dougschaefer/eero-network

v2026.04.27.2

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

Labels

eerowifimeshnetworkingdiagnostics

Contents

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @dougschaefer/eero-network

Release Notes

Remove _client.ts from manifest entrypoint list — it's a shared helper, not a model. The Swamp Club quality scorer lints manifest entrypoints; including _client.ts there exposed slow-type errors and cost the fast-check factor (91% → 100%).

@dougschaefer/eero-networkv2026.04.04.2eero/network.ts
apiRaw eero API call — hit any endpoint directly. Path is relative to /2.2/ (e.g., 'account').
ArgumentTypeDescription
pathstringAPI path after version prefix (e.g., 'account', 'networks/12345/devices')
methodenum
body?record
apiVersionstringAPI 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.
ArgumentTypeDescription
connectedOnlybooleanOnly show currently connected clients (default: true)
settingsGet or update eero network settings — DNS, IPv6, SQM, WPA3, UPnP, band steering.
ArgumentTypeDescription
updates?recordSettings 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.
ArgumentTypeDescription
triggerbooleanSet true to trigger a firmware update. False just checks status.
diagnosticsRun or retrieve eero network diagnostics — connectivity checks, node health.
ArgumentTypeDescription
triggerbooleanSet true to trigger a new diagnostic run.
blacklistList blocked devices or block/unblock a device by MAC.
ArgumentTypeDescription
actionenum
mac?stringDevice 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