Monitor your Bosch Smart System eBike directly from Homey. Keep track of your battery level, remaining range in all assist modes (Eco, Tour, Sport and Turbo), odometer, motor hours, charge cycles, and per-mode riding statistics — all updated automatically every 5 minutes.
Connect once using your Bosch account and Homey will continuously sync your bike’s data from the Bosch cloud. Use Flow cards to get notified when your battery is low, when charging starts or stops, or to automate anything based on your bike’s status. Full hardware details including battery, motor, and component serial numbers are available in the device settings.
Please anyone available to test it and let me know.
Read instructions under settings carefully.
Feedback is appreciated.
Bosch eBike Smart System — Homey Pro App
A Homey Pro app to monitor your Bosch Smart System eBike — battery, range, motor stats, per-mode riding statistics, and full hardware details — all inside Homey.
Important Disclaimer
This integration requires:
ConnectModule hardware installed on your bike (sold separately, ~€100-150)
Bosch eBike Flow+ subscription (~€30-50/year)
Bosch eBike Flow app (Gen 4 and up)
This will NOT work with older Bosch eBike Connect app (Gen 3 and below).
This app is not officially supported, endorsed, or affiliated with Bosch eBike Systems in any way.
The Bosch Smart System does not currently offer a public API for third-party integrations. This app works by using the same private API used by the official Bosch Flow / One Bike App (also known as One Bike App). This approach was reverse-engineered by the community and is used here as a workaround until an official API becomes available.
What this means for you:
Bosch may change or disable this API at any time without notice, which could break the app
Your Bosch account credentials are used only for authentication — no data is stored outside of your Homey
Use at your own risk
If Bosch ever releases an official public API, this app will be updated to use it.
Features
-
Battery state of charge (%) and remaining energy (Wh)
-
Estimated range in all assist modes (Eco / Tour / eMTB / Sport / Turbo)
-
Odometer, motor hours, and charge cycle tracking
-
Per-assist-mode distance and energy consumption
-
Charging status indicator
-
Bike photo displayed on the device tile (from Bosch CDN)
-
Full hardware info in Advanced Settings — battery, motor, connect module, remote, head unit (model, serial, firmware, manufacturing date)
-
Automatic polling every 5 minutes
-
Supports multiple bikes on one account
-
Re-authenticate without removing the device
Requirements
-
Homey Pro (SDK3 — tested on Homey Pro 2023)
-
A Bosch Smart System eBike registered in the Bosch Flow / One Bike App
-
A desktop computer or laptop with Chrome or Firefox (required for the one-time login step — a mobile browser will not work)
-
Your Bosch account login credentials
Adding Your Bike — Step by Step
Because Bosch does not offer a public API, authentication requires a one-time manual step through a desktop browser. This is a workaround to obtain the authorization token that Homey needs to communicate with the Bosch cloud on your behalf.
You only need to do this once per Homey installation, or when your session expires (which is rare with the offline_access token scope).
Step 1 — Generate your Login URL
The app generates a unique, secure login URL for your Bosch account using PKCE (a secure OAuth2 method). You need to copy this URL to your desktop browser.
-
Open the Homey app on your phone
-
Go to More → Apps → Bosch eBike → Settings
-
You will see the Setup tab with a generated Login URL
-
Tap Copy to copy the URL to your clipboard
Step 2 — Sign in and capture the authorization code
This is the trickiest step. Because the Bosch login redirects to a mobile deep link (onebikeapp-ios://) that desktop browsers cannot open, you need to intercept the redirect using Developer Tools.
-
On your desktop computer, open Chrome or Firefox
-
Open Developer Tools:
-
Chrome: press
F12, or right-click anywhere → Inspect -
Firefox: press
F12
-
Click the Network tab in Developer Tools
-
Make sure recording is active (red dot in Chrome, or pause button not active in Firefox)
-
Paste the Login URL into the browser address bar and press Enter
-
The Bosch account login page will appear — sign in with your Bosch / One Bike App email and password
-
After a successful login, the browser will attempt to open a link starting with
onebikeapp-ios://— this will fail, which is completely normal and expected -
In the Network tab, look for a request that starts with
onebikeapp-ios://— it will appear in the list. Click on it. -
The full URL in the request will look like this:
onebikeapp-ios://com.bosch.ebike.onebikeapp/oauth2redirect?code=XXXXXXXXXXXXXXXX&state=... -
Copy the value after
code=and before the next&— that is your authorization code
Tip: The code is a long string of random characters. Copy only the code itself, not the
code=prefix or anything after the&.
Step 3 — Add your bike in Homey
-
Open the Homey app on your phone
-
Go to Devices → + → search for Bosch eBike → tap it
-
On the pairing screen you will see a reminder of the instructions
-
In the Authorization Code field, paste the code you copied from the previous Step 2
-
Tap Next — Homey will connect to Bosch and retrieve your registered bike(s)
-
Select the bike(s) you want to add and tap Add
Your bike will now appear as a device in Homey. The bike photo and all data will appear within 5 minutes on the first poll.
Re-Authentication
Tokens use offline_access scope and last a long time. However if your bike stops updating, re-authentication is needed.
Option A — Via Advanced Settings (quickest, no re-pairing needed):
-
Follow Steps 2–3 above to get a new authorization code
-
Open the device → Settings → Advanced Settings → Connection
-
Paste the new code into the Authorization Code field
-
Tap Save
Option B — Via Repair (full re-pairing):
-
Long-press the device tile → ⋮ → Repair
-
Follow the full pairing flow (Steps 2–4)
-
The device stays in place — only the tokens are updated
Capabilities
Battery
| Capability | Description |
|---|---|
| Battery (%) | State of charge |
| Charging | Whether the battery is currently charging |
| Remaining Energy | Remaining energy in Wh |
| Battery Capacity | Total capacity in Wh |
| Charge Cycles | Total charge cycles (on-bike + off-bike combined) |
| Charge Cycles On Bike | Charge cycles done with battery installed |
| Charge Cycles Off Bike | Charge cycles done with battery removed |
| Lifetime Energy | Total Wh consumed over the battery’s lifetime |
Range Estimates
| Capability | Assist Mode |
|---|---|
| Range Eco | Eco |
| Range Tour | Tour / eMTB |
| Range Sport | Sport |
| Range Turbo | Turbo |
Odometer & Motor
| Capability | Description |
|---|---|
| Odometer | Total distance ridden (km) |
| Motor Hours | Total motor operating hours |
| Motor Hours (Assist) | Hours the motor was actively assisting |
| Max Assist Speed | Speed limit for motor assist (km/h) |
Per-Mode Distance & Energy
Cumulative distance and energy consumption per assist mode: Off / Eco / Tour / Sport / Turbo
Advanced Settings
Open device → Settings → Advanced Settings to see:
Connection — paste a new Authorization Code to re-authenticate
Bike — Brand, Category, Frame ID, Gearing system
Battery — Model, Serial, Firmware, Hardware, Part Number, Manufacturing Date
Motor — Model, Product Line, Serial, Firmware, Hardware, Part Number, Manufacturing Date
Connect Module — Model, Serial, Firmware, Manufacturing Date
Remote / Controller — Model, Serial, Firmware, Manufacturing Date
Head Unit (if fitted) — Model, Serial, Firmware, Manufacturing Date
All fields populate automatically on the first poll.
Flows
Custom trigger cards:
-
eBike charging started
-
eBike charging stopped
-
eBike battery drops below X%
Custom condition cards:
-
eBike is / is not charging
-
eBike battery is above / below X%
All numeric capabilities also automatically generate “becomes greater/less than” flow cards.
App Settings & Debug
Open More → Apps → Bosch eBike → Settings:
Setup tab — login URL generator with Copy button and step-by-step instructions
Debug tab — live log of the last API poll per bike. Use Refresh to reload and Clear to reset.
Known Limitations
-
Unofficial API — Bosch may change or disable access at any time. This is the fundamental limitation of this approach.
-
No ride history — the Bosch API does not expose individual ride data to third-party clients
-
5-minute polling — data reflects the state at the last poll, not real-time
-
Desktop browser required for initial authentication — the authorization code cannot be captured on mobile
-
One Bike App must be set up — your bike must already be registered in the official Bosch Flow / One Bike App before pairing with Homey
