freddy
Get started Go to dashboard

Connect Airthings

Connect Airthings and the readings from your home air-quality monitors become queryable by Claude: radon, carbon dioxide (CO₂), airborne chemicals (VOCs), particulate matter, temperature, humidity, and air pressure. Ask things like "how did my bedroom CO₂ overnight compare to nights I slept well", "was radon elevated this week", or "does humidity track with my resting heart rate".

Air quality is most useful next to everything else you've connected. If you have Oura or WHOOP sleep, Polar HRV, or Garmin recovery in freddy, Claude can line your environment up against how you actually slept and recovered. That blend is the whole point of freddy.

Airthings connects a little differently from most integrations: instead of a one-click login, you create your own small API client in Airthings and paste two keys into freddy. It takes about two minutes.

Connecting

  1. Go to the Airthings API dashboard at consumer-api-doc.airthings.com and open My Applications in the top menu. Log in with the same Airthings account your devices report to.
  2. Click Register new app and choose Client Credentials as the Flow type. (freddy uses read-only access to your current device values, so no other scopes are needed.)
  3. After the app is created, copy its Client ID and Client Secret.
  4. Back in freddy, find the Airthings row in the integrations list and click Connect.
  5. Paste the Client ID and Client Secret into the two fields and click Connect. freddy validates them and starts syncing within a couple of minutes.

The official Airthings walkthrough lives at their getting-started guide if you want the exact screens.

What we sync

freddy reads the latest values from each of your Airthings devices every few minutes and stores them as a timestamped history. Depending on your device, that includes:

The Airthings Consumer API only exposes each device's most recent reading, so freddy builds your history forward from the moment you connect. The longer you stay connected, the richer the trend data Claude can analyze.

Troubleshooting

"Invalid Airthings credentials." Double-check you copied the Client ID and Client Secret correctly, and that the app you created uses the Client Credentials flow type. A client created with any other flow type can't be used here.

No readings are showing up. Your devices need to be online and reporting to the Airthings cloud (via the Airthings app or a Hub). If the Airthings app itself shows current values, freddy will pick them up on the next sync. You can also trigger a manual sync from the Airthings row on your dashboard.

Readings stopped updating. Re-connect from the dashboard with a fresh Client ID and Secret. If you deleted or rotated the API client in the Airthings dashboard, the old keys stop working and you'll need to paste the new ones.

Disconnecting

Click Disconnect on the Airthings row in your dashboard to stop syncing and remove the connection from freddy. Because you created the API client yourself, you can also delete it from My Applications in the Airthings dashboard to fully revoke access.

Need help?

Email support@freddy.coach, or message us in-app at freddy.coach/app/chat.