Skip to main content
The Mentra Bluetooth SDK is the base SDK for building mobile apps that control Mentra Live directly over Bluetooth. It gives Android, iOS, and React Native apps access to scanning, pairing, device status, microphone audio, camera capture, speaker playback, streaming, Wi-Fi, and hardware events. Use this SDK when your app owns the mobile experience and needs a direct phone-to-glasses connection. In Summer 2026, we’ll release MentraOS 3.0, a new SDK for building apps that run on the phone. Learn more in the MentraOS Roadmap June blogpost.

​
Packages

PlatformPackageImport
Androidcom.mentraglass:bluetooth-sdkimport com.mentra.bluetoothsdk.*
iOSMentraBluetoothSDK Swift packageimport MentraBluetoothSDK
React Native / Expo@mentra/bluetooth-sdkimport BluetoothSdk from '@mentra/bluetooth-sdk'

​
What You Can Build

  • Native Android, iOS, or React Native apps that scan for and connect to Mentra Live.
  • Apps that receive button, touch, swipe, head-up, battery, Wi-Fi, hotspot, stream, photo, audio, and SDK log events.
  • Apps that control Mentra Live features such as gallery mode, camera settings, speaker playback, RGB LEDs, Wi-Fi, hotspot, microphone, camera, and streaming.
  • Photo upload to your own webhook and RTMP, SRT, or WebRTC streaming to your own ingest endpoint. The starter kit also includes optional local demo helpers for trying these flows on a LAN.

​
Requirements

  • A physical Android phone or iPhone for real Bluetooth testing.
  • Android min SDK 28 or newer.
  • iOS deployment target 15.1 or newer.
  • React Native / Expo apps must use a development build or production native build. Expo Go cannot load the native SDK.
  • Bluetooth permissions, plus Android location permission where BLE scanning requires it.

Quickstart

Install the SDK, connect to Mentra Live, and read glasses status.

Example Apps

Run the Android, iOS, and React Native starter apps from a fresh clone.

API Reference

Review lifecycle, commands, events, status fields, and Mentra Live behavior.

Troubleshooting

Fix native build, permission, scan, stream, and Expo issues.