MCP.so
Sign In

Aranet4 MCP Server

@diegobit

Basic information

Category

Other

Transports

stdio

Author

diegobit

About Aranet4 MCP Server

SImple MCP server to manage your aranet4 device and local db.

#aranet4#co2

Aranet4 MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aranet4": {
      "command": "{{PATH_TO_UV}}",
      "args": [
        "--directory",
        "{{PATH_TO_SRC}}/aranet4-mcp-server/",
        "run",
        "src/server.py"
      ]
    }
  }
}

Aranet4 MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is aranet4-mcp-server?

aranet4-mcp-server is an MCP server that manages your Aranet4 CO₂ sensor. It scans nearby devices, fetches new data from the sensor's embedded memory, saves measurements to a local SQLite database, and allows querying recent or historical data—including optional visualizations. Built on the Aranet4-Python library, it is intended for users who want to monitor and track air quality through MCP-compatible clients.

How to use aranet4-mcp-server?

Clone the repository, prepare the environment (recommended with uv, alternative with pip install .), and add the server to your MCP client configuration (e.g., Claude Desktop or Cursor). After installation, start your client and ask init aranet4 for guided configuration, or manually edit config.yaml with the device's MAC address. Use the fetch_new_data tool to update the database, and query data with get_recent_data or get_data_by_timerange. Optionally, set up a cron job or LaunchAgent for automatic periodic fetching.

Key features of aranet4-mcp-server

  • Scan for nearby Aranet4 devices via Bluetooth
  • Fetch and store measurement history in a local SQLite database
  • Query recent data or data within a specific time range
  • Generate plots for MCP clients that support images
  • Assisted configuration via the init aranet4 command

Use cases of aranet4-mcp-server

  • Continuously monitor CO₂ levels and temperature in a room
  • Track air quality trends over days or weeks
  • Automate data collection and review historical measurements
  • Integrate sensor data into workflows via MCP clients like Claude

Frequently asked questions

1

How does this server differ from the standalone aranet4-archiver?

aranet4-mcp-server includes MCP integration for use with MCP clients. For a pure Python version without MCP logic, see the separate [aranet4-archiver](https://github.com/diegobit/aranet4-archiver) project.

2

What dependencies are required to run aranet4-mcp-server?

The server depends on the [Aranet4-Python](https://github.com/Anrijs/Aranet4-Python) library. Using `uv` is recommended; with `pip`, run `pip install .` inside the cloned repository.

3

Where is the measurement data stored?

All data is stored locally in a SQLite database created by the server. No external cloud service is required.

4

Can I get visualizations from aranet4-mcp-server?

Yes, for MCP clients that support images, you can ask for a plot when querying recent or historical data. The server will generate and display it.

5

How do I keep the database automatically updated?

You can set up a cron job (any platform) or a LaunchAgent (macOS) to run `fetch-job.py` periodically. An example plist file is included in the repository.

Comments

More Other MCP servers