---
id: pydexcom
version: "0.5.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# pydexcom — Python API to interact with Dexcom Share API

License: permissive · Maintenance: aging · Downloads: 90.1K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 90.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

dexcom glucose readings api, cgm sensor data python, real-time blood glucose monitoring, dexcom share service client, continuous glucose monitor integration, cgm-integration, health-monitoring

[View on SkillFed](https://skillfed.io/packages/pydexcom) · [View on PyPI](https://pypi.org/project/pydexcom/)