glocaltokens

What it is and what it does

glocaltokens is a Python library that retrieves short-lived local authentication tokens for Google Home devices by exchanging Google account credentials with Google's servers. These tokens enable direct local-network communication with Google Home devices via their undocumented local API, bypassing the cloud.

The package handles the OAuth-like flow to obtain master tokens (valid for extended periods) and access tokens (valid 1 hour), then uses those to fetch device-specific local tokens (valid about 1 day). It includes device discovery via zeroconf and supports filtering by device model. The documentation emphasizes storing master tokens rather than credentials, and warns against frequent re-authentication to avoid account lockouts.

Use it for:

• Build local-network home automation that controls Google Home devices without cloud dependency
• Extract and cache device tokens for periodic refresh in a long-running home assistant daemon
• Discover Google Home devices on the network and retrieve their local API endpoints
• Integrate Google Home control into a custom smart-home system using the local API
• Monitor or control timers and alarms on Google Home devices via direct local calls

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Extracts local authentication tokens from Google Home devices by authenticating with Google servers, enabling direct local control of Google Home devices via their local API.

Yes, if you need local control of Google Home devices and are comfortable with the token refresh lifecycle. The package is actively maintained, has no known vulnerabilities, and uses a permissive MIT license. Install friction is low. Main gotchas: tokens expire daily, re-authentication is rate-limited by Google, and the local API is undocumented. Suitable for home automation and local-network integrations.

Install

glocaltokens on PyPI

pip install glocaltokens

uv add glocaltokens

poetry add glocaltokens

Installing glocaltokens

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained as of 2026-08-03 with 60 repository stars. Depends on six runtime packages including grpcio and zeroconf for device discovery and authentication.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart

pip install glocaltokens

from glocaltokens.client import GLocalAuthenticationTokens

client = GLocalAuthenticationTokens(
  username="your_google_email",
  password="your_google_password"
)
master_token = client.get_master_token()
google_devices = client.get_google_devices_json()

Requires Python 3.9 or later. Google credentials must be provided; calling the authentication method too frequently may cause Google to disconnect associated Android devices.

Verify before relying

• Whether the package handles two-factor authentication or app passwords for Google accounts
• How token refresh is managed when the 1-day expiration window approaches
• Whether device discovery works reliably across different network configurations

Package facts

Evidence: glocaltokens-0.7.6-py3-none-any.whl

Keywords: Authentication, Google, Google Home, LocalAuthenticationTokens

Tags

More Software Development packages