Use This MCP server To

Control smart home devices via natural language commands Automate air conditioner settings based on user preferences Monitor environmental sensor data from Nature Remo devices Integrate Nature Remo device status into broader home automation workflows Trigger device actions based on contextual model reasoning Manage multiple Nature Remo devices from a unified MCP interface

README

Nature Remo MCP server

npm version

MCP Server for the Nature Remo API.

Overview

This is an MCP server for Nature Remo, designed to handle requests and interact with the Nature Remo API using the Model Context Protocol SDK. It provides tools to manage and automate interactions with Nature Remo devices.

Prerequisites

Create your own access_token on Nature Remo Home. more detail, see documentation).

Setup

Usage with VS Code

Add the following configuration to your User Settings (JSON) file. Open the settings by pressing Cmd + Shift + P and selecting Preferences: Open User Settings (JSON).

Alternatively, you can create a .vscode/mcp.json file in your workspace to share the configuration with others. Note that the mcp key is not needed in the .vscode/mcp.json file.

Note that the mcp key is not needed in the .vscode/mcp.json file.

{
  "mcp": {
    "servers": {
      "nature-remo": {
        "command": "npx",
        "args": [
          "-y",
          "noboru-i/nature-remo-mcp-server"
        ],
        "env": {
          "ACCESS_TOKEN": "<YOUR_TOKEN>"
        }
      }
    }
  }
}

Usage with Claude Desktop

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "noboru-i/nature-remo-mcp-server"
      ],
      "env": {
        "ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Tools

This server provides the following tools:

list_devices - List devices on the home.
- No parameters required
list_appliances - List appliances on the home.
- No parameters required
operate_tv - Operate a TV appliance.
- applianceId: Appliance id (string, required)
- button: Button label (string, required)
- times: Number of times to press the button (integer, optional)
operate_aircon - Operate an aircon appliance.
- applianceId: Appliance id (string, required)
- airDirection: Air direction (string, optional)
- airDirectionH: Horizontal air direction (string, optional)
- airVolume: Air volume (string, optional)
- button: Button label (string, optional)
- operationMode: Operation mode (string, optional)
- temperature: Temperature (string, optional)
- temperatureUnit: Temperature unit (string, optional)
- times: Number of times to press the button (integer, optional)

License

This project is licensed under the terms of the MIT open source license. Please refer to MIT for the full terms.

nature-remo-mcp-server FAQ

How do I obtain the access token required for this MCP server?

You can create your access token by logging into Nature Remo Home and generating it from your account settings as detailed in the official Nature Remo developer documentation.

Can this MCP server be used with different LLM providers?

Yes, it is provider-agnostic and works with OpenAI, Anthropic Claude, and Google Gemini models.

How do I configure the Nature Remo MCP server in VS Code?

Add the required configuration to your User Settings JSON or create a .vscode/mcp.json file in your workspace with the appropriate settings.

Is it possible to automate device control based on sensor data using this MCP server?

Yes, the server exposes sensor data and device controls that can be used to create automated workflows triggered by environmental conditions.

Does the server support managing multiple Nature Remo devices simultaneously?

Yes, it supports managing and interacting with multiple devices through the MCP interface.

What security measures are in place for accessing Nature Remo devices?

Access is secured via user-generated access tokens, ensuring scoped and authorized interactions with devices.

Can I share the MCP server configuration with my team?

Yes, by placing the configuration in a .vscode/mcp.json file within your workspace, you can share settings easily.