Airthings: connect, sync and troubleshoot

Bring readings from your Airthings monitors alongside sleep and other health records, with each room or device kept identifiable.

Before you connect

Use an Airthings consumer account with devices reporting to its cloud. This connection needs a Client ID and Client Secret from a Client Credentials API client.

Connect

Open Sources in freddy

1. Open the Airthings Consumer API dashboard and its My Applications area. Register an app with the Client Credentials flow.
2. Copy the Client ID and Client Secret. In freddy Sources, choose Airthings and paste them into the matching fields.
3. Save the connection and compare each device’s latest reading with the Airthings app.

What reaches freddy

• Radon, CO₂, VOCs and particulate matter supported by your monitor.
• Temperature, humidity, air pressure and available device battery information.
• Timestamped readings from each connected device, plus supported historical CSV records you upload.

History and updates

The automatic connection reads current device values and builds history forward. For earlier readings, export an IAQ CSV from Airthings, then choose Upload history (.csv) in freddy. Select the correct device, confirm the timezone in which it recorded, and upload the CSV.

If data is missing

• Credentials are rejected: check the flow is Client Credentials and the ID and secret are in the correct fields.
• A room stopped updating: confirm that monitor is reporting to the Airthings cloud before using Sync.
• Imported times look shifted: check the timezone selected for the CSV. Do not import another room’s CSV under the wrong device.

Use it with your other sources

Align my bedroom Airthings CO₂ readings with my Oura sleep times. Show coverage and avoid inferring a cause from the comparison.

Pause or disconnect

Use Paused on the source to stop future sync without deleting its stored history. Disconnect removes the connection and its associated data from freddy; read the confirmation before continuing. It does not delete your records in Airthings. You can also revoke the key or API client in the source service’s settings.

Provider instructions

Airthings Client Credentials setup

Related help

Choose a source

Find missing data and understand sync

Contact freddy support

Use your Airthings data with your AI

Pick your AI for the setup steps and ideas for what to ask.

• Claude Desktop
  On Claude Team and Enterprise, an Owner adds freddy for the organization first.
• ChatGPT
• OpenAI dots
  Availability depends on your OpenAI plan and region.
• Grok Bot
• Grok
• Muse
• Muse Code
• Gemini
  Gemini's custom apps need Gemini Spark, which comes with Google AI Pro or Ultra, and are US and English only.
• Gemini CLI
  Gemini CLI is a developer command-line tool, not the consumer Gemini app. The app connects separately and needs Gemini Spark.
• Claude Code
• Cursor
• Codex
• Perplexity
  Custom connectors require Perplexity Pro, Max, or Enterprise.
• OpenClaw
• Hermes Agent
• Instinct
  Experimental. Instinct is invite only and does not publish steps for adding your own MCP server.
• Hark
  Experimental. Hark does not document a way to add your own MCP server yet, so this may not work today.
• the freddy CLI

freddy is an independent service and is not affiliated with, endorsed by, or sponsored by the makers of the third-party AI apps above.