The Somfy integration will allow users to integrate their Somfy devices into Home Assistant using the official API, unlike the tahoma component.

Setting up developer account

To connect Somfy, you need to set up a developer account.

  1. Visit
  2. Log in using your Somfy credentials.
  3. Open the My Apps menu.
  4. Add a new App:
  • App Name: Home Assistant
  • Callback URL: <YOUR_HOME_ASSISTANT_URL>/auth/somfy/callback
  • Description: Home Assistant instance
  • Product: Somfy Open API
  1. Once Home Assistant restarted, go to Configuration>Integrations.
  2. Select the Somfy integration.


# Example configuration.yaml entry
  client_id: CONSUMER_KEY
  client_secret: CONSUMER_SECRET

Configuration Variables



Your Somfy consumer key.



Your Somfy consumer secret.

Potential duplicate with the Tahoma integration

If you use the tahoma component, you will have to exclude the covers added by this one. Otherwise, they will be added twice.

# Example configuration.yaml entry
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  exclude: ['rts:RollerShutterRTSComponent','rts:CurtainRTSComponent','rts:BlindRTSComponent','rts:VenetianBlindRTSComponent','rts:DualCurtainRTSComponent','rts:ExteriorVenetianBlindRTSComponent','io:ExteriorVenetianBlindIOComponent','io:RollerShutterUnoIOComponent','io:RollerShutterWithLowSpeedManagementIOComponent','io:RollerShutterVeluxIOComponent','io:RollerShutterGenericIOComponent','io:WindowOpenerVeluxIOComponent','io:VerticalExteriorAwningIOComponent','io:HorizontalAwningIOComponent']