Carelink Python Client

Medtronic CareLink Client implemented in Python

• Carelink Python Client
  • Note
  • Supported devices
  • Features
  • Limitations
  • Requirements
  • How to use
    • Clone this repository
    • Install dependencies
    • Get login data
    • Download pump and sensor data
      • Using the CLI tool
      • Using the library
      • Using the proxy tool
        • Systemd service
  • Credits
  • Disclaimer

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).

Note

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.

Supported devices

• Medtronic MiniMed 780G pump

• Medtronic Guardian Connect CGM

• Medtronic MiniMed 770G pump

  • not tested, but should be working

Features

• 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)

Limitations

• CareLink MFA is not supported

Requirements

• 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

How to use

Clone this repository

git clone https://github.com/ondrej1024/carelink-python-client.git
cd carelink-python-client

Install dependencies

pip3 install -r requirements.txt

Get login data

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.

Download pump and sensor data

Using the CLI tool

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

Using the library

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()

Using the proxy tool

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

Systemd service

To run the proxy automatically at system start it can be installed as systemd service using the provided service file:

• systemd/carelink2-proxy.service

Make sure to double check the script's path inside the service file.

Credits

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

Disclaimer

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.