SSyncDev

GoodWe MCP Server

Implementation of MCP server for GoodWe inverters

Remote serverstreamable-httpPython

What is the GoodWe MCP Server?

Implementation of MCP server for GoodWe inverters

What you get

MCP server for monitoring and controlling GoodWe solar inverters over the local network.

  • Read live runtime data: PV production, battery state, grid import/export, load consumption
  • Read and write all configurable inverter settings
  • Switch operation modes (general, eco, backup, peak-shaving, off-grid, …)
  • Control grid export limit and battery depth-of-discharge
  • 7 MCP resources: status, runtime, settings, power flow, daily energy, battery, sensor catalog
  • 6 built-in prompt templates for common workflows (status overview, diagnostics, optimisation, …)

Configuration and credentials

  • Python 3.10+ - GoodWe inverter reachable on the local network (UDP port 8899 or Modbus/TCP port 502)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
connect_inverterConnect to a GoodWe inverter by IP/host
get_connection_statusCheck if connected and show device info
get_device_infoModel name, serial number, firmware version
get_runtime_dataAll live sensor values (optional filter by kind: PV/AC/BAT/GRID/UPS/BMS)
list_sensorsList all sensor IDs and names
read_sensorRead a single sensor by ID
get_settings_dataAll configurable settings and current values
read_settingRead a single setting by ID
write_settingWrite a value to a configurable setting
get_operation_modeCurrent mode and supported modes
set_operation_modeSet mode: general, eco, backup, off_grid, peak_shaving, eco_charge, eco_discharge
get_grid_export_limitGrid export limit in watts
set_grid_export_limitSet grid export limit (0 = disabled)
get_battery_dodBattery depth-of-discharge setting
set_battery_dodSet battery depth-of-discharge (0–99%)

How to install the GoodWe MCP Server

{
  "mcpServers": {
    "goodwe": {
      "command": "goodwe-mcp",
      "env": {
        "GOODWE_HOST": "192.168.1.100"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.10+ - GoodWe inverter reachable on the local network (UDP port 8899 or Modbus/TCP port 502)
VariableDescriptionRequired
GOODWE_HOSTDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use GoodWe to connect inverter.”
  • “Use GoodWe to get connection status.”
  • “Use GoodWe to get device info.”

Frequently asked questions

Implementation of MCP server for GoodWe inverters Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the GoodWe MCP Server

Home Assistant

Enables natural language interaction with Home Assistant entities using the Model Context Protocol.

Hardware & IoT★ 5

Home Assistant

Integrates with Home Assistant to provide smart home control capabilities via Model Context Protocol (MCP).

Hardware & IoT★ 3

1NCE API MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact with the 1NCE IoT connectivity management platform through natural language.

Communication

Agriculture

Agriculture Robotics tools for AI agents. Capabilities: robot safety check, spray plan calcu...

Hardware & IoT

Alexa-mcp

Amazon Alexa for Claude — Echo devices, announcements, routines, smart home, lists

Developer Tools

Alloy

Connect Claude, Cursor, Codex, and other AI tools to your robotics mission data.

Hardware & IoTRemote