pydexcom

What it is and what it does

pydexcom is a thin Python wrapper around the Dexcom Share service API that retrieves real-time continuous glucose monitor (CGM) readings from Dexcom G7, G6, G5, and G4 devices. It authenticates using your Dexcom account credentials and returns glucose values in mg/dL or mmol/L, trend direction, and reading timestamps. The package is primarily used in Home Assistant's Dexcom integration and community projects like Raspberry Pi glucose displays.

The package requires an active Dexcom Share account with at least one follower configured—a prerequisite of the Dexcom Share service itself. It supports regional API endpoints for the US, outside the US, and Japan. Authentication can use email, phone number, or account ID, and the API returns structured glucose reading objects with multiple properties (value, trend, trend_direction, trend_arrow, datetime, JSON representation).

Use it for:

• Integrate real-time Dexcom readings into Home Assistant or other home automation systems for glucose monitoring dashboards.
• Build a personal glucose tracking display on a Raspberry Pi or other single-board computer using live sensor data.
• Fetch current glucose values programmatically for alerting or logging applications that need up-to-the-minute readings.
• Embed glucose data in terminal prompts or status bars for quick at-a-glance monitoring.
• Create custom integrations or bots that react to glucose trends and readings in real time.

Worth the install?

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

Fetches real-time glucose readings from Dexcom CGM sensors via the Dexcom Share service API, returning current blood glucose values, trends, and timestamps.

Yes, if you have an active Dexcom Share account and need real-time glucose readings in Python. The package is lightweight, has no complex dependencies, and works well for its narrow purpose. However, be aware that maintenance is aging (last release 201 days ago), so if the Dexcom Share API changes, updates may be slow. Not suitable if you use Dexcom Stelo or need retrospective data analysis—use the official Dexcom API for that.

Install

pydexcom on PyPI

pip install pydexcom

uv add pydexcom

poetry add pydexcom

Installing pydexcom

Before you install

Low install friction with a single runtime dependency (requests). Maintenance status is aging—last release was 201 days ago—so updates and bug fixes may be infrequent, though the package appears stable for its narrow use case.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for personal projects and integrations.

Quickstart

pip install pydexcom

from pydexcom import Dexcom
dexcom = Dexcom(username="user@email.com", password="password")
glucose_reading = dexcom.get_current_glucose_reading()
print(glucose_reading.value)  # e.g., 85

Requires Python >=3.9 and an active Dexcom Share account with at least one follower configured in the Dexcom mobile app.

Verify before relying

• Whether the package continues to work reliably with the current Dexcom Share API, given the aging maintenance status and lack of recent commits.
• Support status for newer Dexcom devices beyond G7/G6/G5/G4.
• Whether regional endpoints (us, ous, jp) remain stable and functional.

Package facts

Evidence: pydexcom-0.5.1-py3-none-any.whl

Keywords: dexcom

Tags

More Monitoring packages