GeoSuite Cosy Smart Thermostat

Saggerus · November 24, 2019, 2:21pm

I got a ‘free’ Cosy smart thermostat a few years back as part of a deal from my then energy supplier. They don’t appear to offer a public API to control it, so I built a little work around to allow it to be controlled using Home Assistant. It’s a Node app (wrapped up in a Docker image) which uses puppeteer to log onto the Cosy web app, and pull the current status or set the mode. It listens for MQTT messages and acts accordingly.
Doubt there’s many of these thermostats knocking around, so not sure if anyone else will find it useful, but just in case (or if anyone is interested in the code to do something similar with another device), I’ve stuck it on GitHub:
https://github.com/Saggerus/HA-cosy-server

It’s a little bit buggy at the moment (gives thed odd timeout as I haven’t added error handling).

But it does still do what bit’s supposed to.

dan-agilexp · January 9, 2021, 7:31pm

Hey there @Saggerus .

Your efforts and your GitHub repo inspired me to create something similar. Its a NuGet package for C# .NET that allows Cosy devices to be controlled using their non-public API (its the same API that their Geo Cosy Web App calls) rather than using a headless browser, which was a bit better for my use case.

I just needed it so help me create an IFTTT app so that I can set the heating based on outside triggers like calendar events, emails, etc. I wapped it up in a NuGet package just in case its useful for anyone.

github.com

dan-agilexp/cosyrest/blob/main/README.md

# Description

CosyRest is a NuGet package which provides a wrapper around the non-advertised REST API for the Geo Cosy Smart Thermostat.

Geo Cosy do not advertise a public API for interacting with their smart thermostats. However by inspecting the API calls made by the [Geo Cosy Web App](https://cosy.geotogether.com/) it is easy to replicate the calls using cURL to obtain a token and then perform operations on the smart thermostat.

This NuGet package wraps up those API calls to provide a simple Geo Cosy client.

Warning: As the Geo Cosy API is not advertised publicly, it is subject to change at any time by them without any prior notification. Therefore if you want to control the Geo Cosy thermostats for any critial or commercial application I suggest you get in touch with them directly. However, presuming their hardware (the Geo Cosy smart thermostat and Cosy hub uses these same API calls, I would say its unlikely to change much while the product is supported.

# Motivation

I wanted to control my heating with automation for example to "make it cosy" one hour before a scheduled AirBnB check-in.
Although GeoCosy has an Alexa skill there is nothing similar for IFTTT or a public API so I set about building my own.
The inspiration came from [this GitHub Repo](https://github.com/Saggerus/HA-cosy-server) but using a headless browser to simulate clicking around the web interface wasn't quite what I was after and plus I wanted a do it using .NET.
However the project above might better suit your needs to worth checking out.

# Installation

To install this package into your .NET 5 application, use the following command:

This file has been truncated. show original

Saggerus · January 22, 2025, 10:27pm

Hi @dan-agilexp , your efforts especially the work around inspecting the API inspired me right back! I’ve done the same and used the calls to create a full custom integration. If anyone is interested you can find it here: https://github.com/Saggerus/geo_cosy.git

markhealey · January 26, 2025, 6:07pm

This works absolutely perfectly!
Five years of trying to get it working with anything resolved in five minutes!
Thank you so much.

Saggerus · January 26, 2025, 9:13pm

@markhealey You’re welcome, glad it worked for you!