Skip to main content

Python3 API for the Netatmo Weather Station

Project description

Build Status pyi pyi

Python 3 API to retrieve data from the Netatmo connected weather station.

The library implements the authentication, the token refresh and the both weather station methods Getstationdata and Getmeasure.

Although Netatmo provides samples written in Python, this library provides - I hope! - more high level methods to access the data.


The easiest way to install the library is using pip:

pip3 install netatmo

You can also download or clone the GitHub repository and install the module:

cd /path/to/repo
python3 install

Finally, you may get the source file and use it in your projects.


  • Python 3 (sorry if you live in legacy)
  • The requests module (should be included in any decent Python distribution)
  • A valid Netatmo account with at least one weather station
  • A client_id / client_secret pair from Netatmo developper program (see Create your app)

Command-line usage


netatmo -h
netatmo <command> -h

where <command> can be one of these keywords: config, fetch, list, test, dump.


The library reads the username/password and client id/secret from a .rc file. By default, it is ~/.netatmorc. It could be edited by hand, or written by the library with the config command.

netatmo config -u user@mail -p password -i client_id -s client_secret -d 70:ee:50:xx:xx:xx

Without any option, config only prints the current configuration.

$ netatmo config
Read config
username: user@mail
password: password
client_id: 1234567890abcdef12345678
client_secret: ABCdefg123456hijklmn7890pqrs
default_station: 70:ee:50:xx:xx:xx

Display the authorized stations

netatmo list

Fetch data into CSV files

netatmo fetch

This command will write two CSV files, netatmo_station.csv and netatmo_module.csv. The most recent measures are appended to these files depending on the last timestamps.

Other commands and options

test tests the connection. On success, exit code is zero. On failure, non zero, like any shell command.

dump displays more data from the weather station.

Each option -v increases the verbosity. The option -c can be use to use an alternate configuration file.

Both -v and -c have to be placed before the command.

Usage as a Python module

#! /usr/bin/env python3

import netatmo

# fetch data using ~/.netatmorc credentials

# credentials as parameters
ws = netatmo.WeatherStation( {
        'client_id': '1234567890abcdef12345678',
        'client_secret': 'ABCdefg123456hijklmn7890pqrs',
        'username': 'user@mail',
        'password': 'password',
        'device': '70:ee:50:XX:XX:XX' } )

License and warranty

None and none.

It is NOT an official software from Netatmo and it is not endorsed or supported by this company.

This library has been written as a personal work. Feel free to improve or adapt it to your own needs.


Other Netatmo devices

This library has been tested only with the weather station and its interior module. I don't know if it works well with the windgauge or the pluviometer. Other devices are unsupported, but their methods could be easily added. See Netatmo Connect APIs.

Installation on a Synology NAS

Synology provides a Python 3 package that lacks the requests module. Here is an simple download method, without git, pip or

curl -sL | tar -xzf - --strip-components=1 --wildcards '*/requests'

Alternately, you can use Anaconda as Python3 distribution.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netatmo-1.0.7.tar.gz (10.4 kB view hashes)

Uploaded source

Built Distributions

netatmo-1.0.7-py3.8.egg (10.4 kB view hashes)

Uploaded 1 0 7

netatmo-1.0.7-py3.7.egg (10.4 kB view hashes)

Uploaded 1 0 7

netatmo-1.0.7-py3.6.egg (10.4 kB view hashes)

Uploaded 1 0 7

netatmo-1.0.7-py3-none-any.whl (11.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page