The Mentra Bluetooth SDK is the base SDK for building mobile apps that control smart glasses directly over Bluetooth. It gives Android, iOS, and React Native apps access to scanning, pairing, device status, microphone audio, camera capture on camera-equipped models, speaker playback on speaker-equipped models, streaming, Wi-Fi, hardware events, and display commands on display-equipped models. Use this SDK when your app owns the mobile experience and needs a direct phone-to-glasses connection.
If you are building a cloud Mini App that runs through MentraOS, start with the App Devs docs and the Mentra Cloud SDK (@mentra/sdk). If you are building a mobile app that talks to glasses over Bluetooth, use this Bluetooth SDK.

​
Packages

PlatformPackageImport
Androidcom.mentra:bluetooth-sdkimport com.mentra.bluetoothsdk.*
iOSMentraBluetoothSDK CocoaPodimport 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 MentraOS-compatible glasses.
  • Apps that display text, clear the display, and open the dashboard on display-equipped glasses such as G2.
  • Apps that receive button, touch, swipe, head-up, battery, Wi-Fi, hotspot, stream, photo, audio, and SDK log events.
  • Apps that control model-supported features such as dashboard position, head-up angle, gallery-button behavior, 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.

​
Bluetooth SDK vs Cloud SDK

Use caseSDK
Build a mobile app that connects directly to glasses over BluetoothMentra Bluetooth SDK
Build a cloud Mini App that users launch from MentraOSMentra Cloud SDK (@mentra/sdk)
Need CoreBluetooth, Android BLE, native permissions, and mobile lifecycle controlMentra Bluetooth SDK
Need server-side sessions, webhooks, app store distribution, and MentraOS relay featuresMentra Cloud SDK (@mentra/sdk)

​
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 model differences.

Troubleshooting

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