Test your integration with the Health Connect Toolbox
Stay organized with collections
Save and categorize content based on your preferences.
The Health Connect Toolbox is a companion developer tool to help you test
your app's integration with Health Connect. It can read and write data directly
to Health Connect, allowing you to test your app's operations.
You can download the APK to use it for your test cycle.
Extract the ZIP file to get the APK files. Then, to install the Toolbox APK on
a connected device, use adb. Navigate to the folder where the APK is located
and run the following command:
To manage read and write permissions for testing, open the Health
Connect app from either the main screen of the Toolbox app or go directly to
the permission flow.
Read and write health records
Health Connect Toolbox supports reading and writing all Health Connect data
types.
To insert a new health record:
Tap on Insert Health Record.
Select a category.
Select a health record type.
Enter the value.
Tap the SAVE button.
To read the health records from other apps:
Tap on Read Health Record.
Enter the data type.
Select the time period for query.
Tap the READ button.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-04-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-28 UTC."],[],[],null,["# Test your integration with the Health Connect Toolbox\n\nThe Health Connect Toolbox is a companion developer tool to help you test\nyour app's integration with Health Connect. It can read and write data directly\nto Health Connect, allowing you to test your app's operations.\nYou can download the APK to use it for your test cycle.\n\n[Health Connect Toolbox](https://goo.gle/health-connect-toolbox)\n\nExtract the ZIP file to get the APK files. Then, to install the Toolbox APK on\na connected device, use `adb`. Navigate to the folder where the APK is located\nand run the following command: \n\n $ adb install HealthConnectToolbox-{Version Number}.apk\n\n| **Note:** The Health Connect Toolbox is actively maintained and the `{Version Number}` is expected to be updated with each release. Review the extracted APK from your downloaded ZIP file and make the appropriate changes to the command.\n\nTo manage read and write permissions for testing, open the Health\nConnect app from either the main screen of the Toolbox app or go directly to\nthe permission flow.\n\nRead and write health records\n-----------------------------\n\nHealth Connect Toolbox supports reading and writing all Health Connect data\ntypes.\n\nTo insert a new health record:\n\n1. Tap on **Insert Health Record**.\n2. Select a category.\n3. Select a health record type.\n4. Enter the value.\n5. Tap the **SAVE** button.\n\nTo read the health records from other apps:\n\n1. Tap on **Read Health Record**.\n2. Enter the data type.\n3. Select the time period for query.\n4. Tap the **READ** button."]]
