Nature Remo MCP server

by noboru-i

7 stars
232 downloads
Not rated
GitHub Website

About

An MCP (Model Context Protocol) server that wraps the Nature Remo API, allowing AI assistants to manage and automate interactions with Nature Remo smart home devices such as TVs and air conditioners. It is designed for developers who want to control their Nature Remo appliances…

Details

Author
noboru-i
GitHub stars
7
Downloads
232
Categories
Other

- List all devices registered on your home.
- List all appliances registered on your home.
- Operate a TV appliance (press buttons multiple times).
- Operate an air conditioner (adjust mode, temperature, direction, volume).
- All interactions require a valid Nature Remo access token.
- Uses standard MCP SDK for seamless integration with compatible hosts.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Nature Remo MCP server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the server in your MCP client (VS Code or Claude Desktop) using the npx -y noboru-i/nature-remo-mcp-server command. Set the ACCESS_TOKEN environment variable to your Nature Remo access token (obtained from Nature Remo Home). Add the JSON configuration snippet to your user settings or mcpServers block.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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

1. 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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.