g-family-link

Unofficial TypeScript client for the Google Family Link API — usable as a library or CLI, focused on time control

⚠️ Disclaimer: This project is not affiliated with, endorsed by, or associated with Google LLC in any way. Google Family Link is a trademark of Google LLC. Use of the Google Family Link name and logo is solely for identification purposes. This is an independent, community-driven project developed through reverse engineering of the public API.

This project is intended for personal and research use only. It must not be used for commercial purposes, sold, or otherwise financially exploited.

Users authenticate using cookies from their own Google account sessions. No credentials are stored or transmitted by this library beyond what is necessary to call the API on behalf of the authenticated user. The API endpoints and key used are publicly accessible from the Family Link web interface and are reused solely to enable authenticated access — no impersonation of Google or its services is intended.

Note to Google employees: If this repository raises any concerns regarding intellectual property, terms of service, or any other matter, please reach out via GitHub Issues or directly to @ludufre. I will promptly take down or modify the repository upon request — no legal action necessary.

Maintainers

| Maintainer | GitHub | Social | LinkedIn | | ---------------------- | ------------------------------------- | --------------------------------- | ------------------------------------------------------------------ | | Luan Freitas (ludufre) | ludufre | @ludufre | Luan Freitas |

Installation

Requires Node.js ≥ 18.

# as a library
npm install g-family-link

# as a global CLI
npm install -g g-family-link

# or using pnpm
pnpm add g-family-link
pnpm add -g g-family-link

Documentation

• CLI Reference — authentication, all commands and options
• Library API — FamilyLink class, methods, and low-level API
• Types Reference — types, interfaces, and errors

Building from source

pnpm install
pnpm build       # outputs to dist/