air-Q
Connects Claude directly to air-Q air quality sensors on your local network via HTTP. Exposes tools for reading current sensor data (CO2, VOC, PM2.5, etc.), pulling historical readings, generating plots and Excel exports, and configuring device settings like LED themes and night mode schedules. Built on aioairq, the official async Python library. Supports multi-device setups with location and group filtering, so you can query all sensors in a room or building at once. The same executable doubles as a CLI for shell scripting and pipes. Useful if you're monitoring indoor air quality and want Claude to analyze trends, set thresholds, or automate responses based on live sensor readings.
- tools
- 20
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Aug 5, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
list_devicesList all configured air-Q devices (with location/group if set)
List all configured air-Q devices (with location/group if set)
No parameter schema in public metadata yet.
get_air_qualityGet sensor readings — by device, location, or group
Get sensor readings — by device, location, or group
No parameter schema in public metadata yet.
get_air_quality_historyGet historical sensor data as column-oriented JSON
Get historical sensor data as column-oriented JSON
No parameter schema in public metadata yet.
plot_air_quality_historyRender one historical chart per sensor across all matching devices
Render one historical chart per sensor across all matching devices
No parameter schema in public metadata yet.
export_air_quality_historyExport one historical sensor as one csv/xlsx across matching devices
Export one historical sensor as one csv/xlsx across matching devices
No parameter schema in public metadata yet.
get_device_infoGet device metadata (name, model, firmware version)
Get device metadata (name, model, firmware version)
No parameter schema in public metadata yet.
get_configGet full device configuration
Get full device configuration
No parameter schema in public metadata yet.
get_logsGet device log entries
Get device log entries
No parameter schema in public metadata yet.
identify_deviceMake device blink its LEDs for visual identification
Make device blink its LEDs for visual identification
No parameter schema in public metadata yet.
get_led_themeGet current LED visualization theme
Get current LED visualization theme
No parameter schema in public metadata yet.
get_possible_led_themesList all available LED visualization themes
List all available LED visualization themes
No parameter schema in public metadata yet.
get_night_modeGet current night mode configuration
Get current night mode configuration
No parameter schema in public metadata yet.
get_brightness_configGet current LED brightness configuration
Get current LED brightness configuration
No parameter schema in public metadata yet.
set_device_nameRename a device
Rename a device
No parameter schema in public metadata yet.
set_led_themeChange LED visualization (CO₂, VOC, Humidity, PM2.5, …)
Change LED visualization (CO₂, VOC, Humidity, PM2.5, …)
No parameter schema in public metadata yet.
set_night_modeConfigure night mode schedule and settings
Configure night mode schedule and settings
No parameter schema in public metadata yet.
set_brightnessAdjust LED brightness (day/night)
Adjust LED brightness (day/night)
No parameter schema in public metadata yet.
configure_networkSet static IP or switch to DHCP
Set static IP or switch to DHCP
No parameter schema in public metadata yet.
restart_deviceRestart the device (~30s downtime)
Restart the device (~30s downtime)
No parameter schema in public metadata yet.
shutdown_deviceShut down the device (manual restart required)
Shut down the device (manual restart required)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
AIRQ_CONFIG_FILEPath to the air-Q device configuration JSON file
AIRQ_DEVICESsecretInline JSON array with configured air-Q devices
Readme
mcp-airq
MCP server for air-Q air quality sensor devices. Enables Claude Desktop, Claude Code, and other MCP clients to directly query and configure air-Q devices on your local network.
Built on aioairq, the official async Python library for air-Q.
The same mcp-airq executable also works as a direct CLI when you pass a tool
name as a subcommand.
Installation
Details
- Repository
- github.com/corantgmbh/mcp-airq
- Package
mcp-airq- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active