Using Octopus Home Mini from Linux - how?

Sep 16, 2025 Last reply: 10 months ago 4 Replies

I'm pretty sure I have seen odd messages here about getting data from an Octopus Home Mini by other means than connecting to an app in a phone.



My Octopus Home Mini has just arrived and I really don't want to use it from a 'phone, my smartphone spends most of its life turned off in my study.



I'm all Linux based on my laptop and my desktop so if anyone can point me at some information on how to access the data from Linux I'd be very grateful.


Does it connect to the phone by Bluetooth? Or does the phone connect to the Octopus servers?

When you know that you can figure where to go next with your laptop.

The Mini sends the data to the Octopus servers and the phone app picks it up from there.

The way to get the data out of Octopus is via their API. They have two - a REST API which is simpler to use but has limited reach, and a GraphQL API which is richer but more complicated: https://docs.octopus.energy/ I've not experimented with the live meter readings from the Mini. But there are a lot of projects out there which use the API and plug into systems like Home Assistant, and lots of Python/etc code to talk to the API.

It looks like somebody has written the GraphQL query to get the Home Mini data:

formatting link
so it's a case of something to issue GraphQL requests and download the data into whatever format you wanted. Somebody has some examples of that using cURL:
formatting link

(I did mess about with the GraphQL to try to get the times of their free energy hours, but that was a trial and they hadn't implemented that on the API at that point so I didn't get far. There's also a Home Assistant script which automatically enrolls you in every 'saving session' using the API, which did work for me.)

Theo

Thanks Theo, that's just what I wanted to know, now I can do some sensible searches to find what I want.

FWIW there appear to be two APIs:

https://docs.octopus.energy/is labelled 'Octopus Energy API Documentation'

and https://developer.octopus.energy/is "Octopus Energy UK API Documentation"

Since they operate in other countries now, I suppose the bottom one is the more relevant one. But don't know for sure.

Theo

Join the Discussion

Have something to add? Share your thoughts — no account required.

Didn't find your answer?

Ask the community — no account required