[APP][Pro][TEST] Moodo SDK v3

Apps
1

Hi everyone,

This topic covers the new Homey Apps SDK v3 implementation for Moodo smart fragrance diffusers. The app connects to Moodo’s cloud services and lets Homey control a diffuser, monitor its state and use saved essences in Flows.

This is a new app with the app ID nl.nobrainer.moodo. During testing it does not automatically replace or migrate devices from the older co.moodo app. The existing app is expected to be removed after this app has passed certification.

Test version:

Moodo | Homey

Current test version

Version: 2026.8.2
Platform: Homey Pro / Apps SDK v3
Connection: Moodo cloud REST API and realtime service

Main features

  • Discover and add Moodo diffusers through your Moodo account
  • Switch a diffuser on or off and set its overall fan speed
  • Set the intensity of each of the four capsule slots separately
  • View capsule names, intensity and remaining fragrance when reported by Moodo
  • View battery level, charging state and power-adapter status on supported models
  • Switch between diffuser and purifier mode on compatible devices
  • Select Off, Economy, Efficient or Powerful interval mode
  • Enable or disable shuffle mode
  • View the active essence
  • Show only saved essences that match the installed capsules, with a safe fallback if Moodo does not provide enough capsule information
  • Receive realtime state updates, with periodic synchronization as a fallback
  • Automatically recover after temporary Moodo or network errors
  • Reconnect an expired Moodo session through device repair

Model-dependent controls and sensors are only added when the Moodo API reports that the device supports them.

Flow support

The app includes Flow triggers for:

  • Essence changes
  • Capsule changes, including capsule number, essence and intensity
  • Lost connections
  • Restored connections

The available condition checks whether the Moodo device is connected.

Flow actions are available to:

  • Set a saved essence
  • Set an individual capsule intensity
  • Select diffuser or purifier mode
  • Set the interval mode
  • Enable or disable shuffle
  • Turn the diffuser on for a configurable number of minutes
  • Refresh the device status

Homey’s standard on/off and dim Flow cards can also be used for power and overall fan-speed control.

Pairing and account security

During pairing, enter the email address and password of your Moodo account. The credentials are sent directly to Moodo to obtain an access token. The password is not stored by the Homey app.

The access token is stored locally in Homey’s app settings. The current test version supports one Moodo account per app installation.

Requirements and limitations

  • Homey Pro with firmware 12.9.0 or newer
  • A working Moodo account
  • A Moodo diffuser connected to the Moodo service
  • Internet access from Homey Pro

This integration depends on Moodo’s cloud services. I checked Moodo’s published API information and reference integrations, but found no documented or supported local API or direct LAN protocol. Local control cannot be added reliably unless Moodo publishes such an interface or its protocol becomes available for testing.

Languages

Visible app texts are available in English and Dutch.

Please test the app and report what works well and what can be improved. Feedback about pairing, multiple diffusers, individual capsule control, remaining fragrance, battery and adapter status, favorites, device modes, realtime updates and Flow cards is especially useful.

When reporting an issue, please include your Moodo model and the function you were testing. Do not post passwords, access tokens or other credentials.

2

Wow, thanks! Your app works splendid on Homey Pro early 2023. Happy that we can use our Moodo with Homey again!!!

André

3

Good to hear it, thanks for testing and replying.

4

Your app works fine on my Homey 2016 as well. Replaced the original app with yours.

5

Hi Brian,

Do you know if the Moodo diffuser supports any kind of local API or direct LAN communication?

I’m interested in controlling it locally without relying on Moodo’s cloud servers. Do you think this could be possible, or could your integration potentially be adapted for local control?

Thanks!

6

Hi @mradolov,

I checked Moodo’s published API information and the available reference integrations. I could not find a documented or supported local API or direct LAN protocol for the Moodo diffuser. The current Homey integration therefore still uses Moodo’s cloud REST API and realtime WebSocket service.

Adapting it for local control would currently require reverse-engineering an undocumented protocol, assuming the device exposes one at all. That would be difficult to support reliably. If Moodo publishes a local interface, or if protocol documentation and test access become available, I can investigate it further.

Version 2026.8.2 has now been prepared with several other improvements:

  • Individual intensity control for all four capsule slots
  • Remaining fragrance level when reported by Moodo
  • Battery, charging and power-adapter status on supported models
  • Diffuser and purifier mode on compatible devices
  • Favorites filtered to match the installed capsules
  • New Flow actions for capsule intensity and device mode

These additions improve device control and status information, but they do not remove the current cloud dependency.

7

Thank you for looking into this and for the improvements in version 2026.8.2.

I have tried contacting Moodo support myself, but unfortunately I haven’t received any response from them.

Do you happen to know whether it is currently still possible to order Moodo devices and fragrance capsules directly from their website? Also, since you are developing and maintaining the Moodo integration for Homey, do you perhaps have a way of contacting Moodo directly regarding the API or obtaining technical information from them?

It would be very interesting to know whether they could provide any information about a possible local API or LAN control, even if it is not publicly documented.

Thank you again for your work on the integration.

8

Hi @mradolov,

Just to clarify my role: I only converted and modernized the existing open-source Homey integration to Homey Apps SDK v3, and I maintain this Homey app. I do not own a Moodo device, I am not affiliated with Moodo or MoodoAir, and I have no direct contact or private technical channel with them. This also means that hardware-specific changes depend on feedback and testing from Moodo owners.

I checked the currently available public information as of 29 August 2026:

Based on those signals, I found no indication that MoodoAir is bankrupt or in liquidation, and Moodo products appear to remain available for sale. However, I cannot independently verify whether orders are currently being fulfilled, how responsive support is, or how long the cloud service will remain operational without placing an order or receiving confirmation from Moodo.

Regarding local control, I still have not found a documented local API or LAN protocol. Because I have no hardware, documentation or direct contact with Moodo, I cannot investigate an undocumented local protocol myself. If Moodo publishes technical information, or if a Moodo owner can provide controlled testing and non-sensitive diagnostics, I can review whether local support is technically feasible.