airthings
Get information about my Airthings air quality monitoring devices and their current sensor readings.
LABSCO SUMMARY
The readings and the thing that answers them are on the same connection.
Asking what the air is like in here and then turning the purifier up is one exchange rather than a measurement followed by a trip to the phone app — and the assistant sees the numbers it is reacting to, including which room is which.
What it is
A server for Airthings consumer devices: the monitors on your account with their current sensor readings, and remote control of an Airthings Renew air purifier.
What you get
- Every Airthings monitor on the account with what it is reading right now — radon, CO2, temperature, humidity, VOCs, particulates and pressure
- A device that has stopped reporting showing up as such, rather than as stale numbers presented as current
- The Renew purifier's current remote control state, read by serial number
- Its mode set to OFF, AUTO, SLEEP, BOOST or MANUAL, with a fan speed from 1 to 5 required when you pick MANUAL
Requirements
An Airthings account with devices on it and API credentials for that account. Runs over stdio from npm as airthings-consumer-mcp; Claude Desktop can install the packaged extension from the repository's releases instead of editing a config file.
Setup effort
One command plus credentials — npx -y airthings-consumer-mcp, then supply credentials
USE CASES
01
Asking whether the air in here is actually fine
Read every monitor at once and get the numbers with the room they came from, including any device that has gone quiet.
02
Turning the purifier up because of what you just read
Check the Renew's current mode, then set it to BOOST — or to MANUAL with the fan speed you want.
03
Settling it down for the night
Put the purifier into SLEEP or back to AUTO once the readings have come down, without opening an app.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
airthings-remote-control-get
Get the current remote control state of an Airthings Renew air purifier.
airthings-remote-control-set
Set the remote control mode of an Airthings Renew air purifier. Available modes: OFF, AUTO, SLEEP, BOOST, MANUAL. Fan speed (1-5) is required for MANUAL mode.
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
- npx on PATH
- AIRTHINGS_CLIENT_ID in your environment
- AIRTHINGS_CLIENT_SECRET in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"airthings-consumer-mcp": {
"command": "npx",
"args": [
"-y",
"airthings-consumer-mcp"
],
"env": {
"AIRTHINGS_CLIENT_ID": "<YOUR_AIRTHINGS_CLIENT_ID>",
"AIRTHINGS_CLIENT_SECRET": "<YOUR_AIRTHINGS_CLIENT_SECRET>"
}
}
}
}npx
TERMINAL
npx -y airthings-consumer-mcp
