Medtronic CareLink Client implemented in Python
Python library, which can be used for retrieving data from Medtronic CareLink of online CGM and insulin pump device data uploads (Guardian Connect, MiniMed 7xxG).
This is a developer version. Works for me. Extensive testing of different use cases is needed. Please report back if it works also or you.
-
- not tested, but should be working
- Works with Carelink patient and follower account
- Automatic refresh of access token
- Local storage of token data
- Function for downloading current pump and sensor status plus last 24h data from CareLink Cloud
- CareLink Client CLI (console example program)
- CareLink Client Proxy (daemon example program for providing the CareLink data in the local network)
- CareLink MFA is not supported
-
Patient or Care Partner account (same as for the CareLink Connect app)
- in case of a Care Partner account: successful pairing with the Patient's account (see more info)
-
Runtime: Python3 and some libraries
git clone https://github.com/ondrej1024/carelink-python-client.git
cd carelink-python-client
pip3 install -r requirements.txt
The Carelink Client library needs the initial login data stored in the logindata.json file. This file is created by running the login script on a PC with a screen.
The script opens a Firefox web browser with the Carelink login page. You have to provide your Carelink patients or follower credentials and solve the reCapcha. On successful completion of the login the data file will be created.
python3 carelink_carepartner_api_login.py
The Carelink Client reads this file from the local folder and it will take care of refreshing automatically the login data when it expires. It should be able to do so within one week of the last refresh.
carelink_client2_cli.py is an example Python application which uses the carelink_client2 library to download the patients Carelink data to a file via the command line.
Use the -h option for more info. Basic usage:
python carelink_client2_cli.py --data
carelink_client2.py is a Python module that can be used in your own Python application. Basic usage:
import carelink_client2
client = carelink_client2.CareLinkClient(tokenFile="logindata.json")
if client.init():
client.printUserInfo()
recentData = client.getRecentData()carelink_client2_proxy.py is a Python application which uses the carelink_client2 library. It runs as a service and downloads the patients Carelink data periodically and provide it via a simple REST API to clients in the local network.
Use the -h option for more info. Basic usage:
python carelink_client2_proxy.py
The proxy provides the following API endpoints which can be queried with an HTTP GET request:
<proxy IP address>:8081(Status info)<proxy IP address>:8081/carelink(complete data, in json format)<proxy IP address>:8081/carelink/nohistory(only current data without last 24h history, in json format)
For documentation of the data format see doc/carelink-data.ods
To run the proxy automatically at system start it can be installed as systemd service using the provided service file:
Make sure to double check the script's path inside the service file.
This project is based on other peoples work which I want to thank for their efforts.
-
Pal Marci for reversing the Carelink Cloud API communication of the "Carelink Connect" app
-
Bence Szász for the Java implementation of the xDrip Carelink Follower
This project is intended for educational and informational purposes only. It relies on a series of fragile components and assumptions, any of which may break at any time. It is not FDA approved and should not be used to make medical decisions. It is neither affiliated with nor endorsed by Medtronic, and may violate their Terms of Service. Use of this code is without warranty or formal support of any kind.