
Connects Claude to the air-Q Cloud REST API for remote air quality monitoring. Exposes five read-only tools: list your configured devices, pull current sensor readings, query historical data as JSON, render time-series charts (PNG/SVG/HTML), and export CSVs or Excel files. Unlike the local network version (mcp-airq), this hits the cloud endpoint, so you can check CO₂, PM2.5, and other metrics from anywhere. Supports device grouping by location or custom tags, timezone-aware timestamps, and downsampling for large date ranges. The same binary works as a standalone CLI, so you can pipe readings to jq or generate charts from cron without spinning up the MCP server.
Public tool metadata for what this MCP can expose to an agent.
list_devicesList configured air-Q Cloud devicesList configured air-Q Cloud devices
No parameter schema in public metadata yet.
get_air_qualityGet latest sensor readings (supports device/location/group selection)Get latest sensor readings (supports device/location/group selection)
No parameter schema in public metadata yet.
get_air_quality_historyGet historical data within a time range as column-oriented JSONGet historical data within a time range as column-oriented JSON
No parameter schema in public metadata yet.
plot_air_quality_historyRender one historical chart per sensor across all matching devicesRender 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` or `xlsx` across matching devicesExport one historical sensor as one `csv` or `xlsx` across matching devices
No parameter schema in public metadata yet.
Sponsors
AIRQ_CLOUD_CONFIG_FILEPath to the air-Q Cloud device configuration JSON file
AIRQ_CLOUD_DEVICESsecretInline JSON array with configured air-Q Cloud devices
AIRQ_CLOUD_API_KEYsecretGlobal fallback API key (used when per-device api_key is omitted)
MCP server for the air-Q Cloud API — access air quality data from anywhere.
Unlike mcp-airq (which communicates directly with devices on the local network), this server uses the air-Q Cloud REST API to retrieve sensor data remotely.
The same mcp-airq-cloud executable also works as a direct CLI when you pass a
tool name as a subcommand.
mcp-airq-cloud