EcoFlow MCP Server

MCP (Model Context Protocol) server for controlling and monitoring EcoFlow Power Stations.

Features

• List Devices - View all EcoFlow devices linked to your account

• Device Status - Get comprehensive status including battery level, power flow, temperatures

• Solar Input - Monitor solar panel power generation

• AC Output Control - Enable/disable AC output with X-Boost and voltage settings

• DC Output Control - Enable/disable DC (12V car port) output

• Charging Settings - Configure max/min charge levels and charging power

• Standby Timeouts - Set auto-off timers for device, AC, DC, and LCD

• Raw Quota Access - Access all device parameters for debugging

Supported Devices

• DELTA series (Delta, Delta Max, Delta Pro, Delta 2, Delta 2 Max, Delta Pro 3)

• RIVER series (River, River Max, River Pro, River 2, River 2 Max, River 2 Pro)

• PowerStream micro-inverter

• Smart Plug

• And other EcoFlow devices with API support

Setup

1. Get API Credentials

1. Register at EcoFlow Developer Platform

2. Wait for approval (can take up to a week)

3. Go to your profile and generate Access Key and Secret Key

2. Install Dependencies

3. Configure MCP

Add to your ~/.claude/user-mcps.json:

Regional API

By default, the server uses https://api.ecoflow.com (US/Americas). For Europe, set:

Available Tools

ecoflow_list_devices

List all EcoFlow devices linked to your account.

ecoflow_get_device_status

Get comprehensive status for a device including battery level, power input/output, and more.

• serial_number (required): Device serial number

ecoflow_get_solar_input

Get solar panel input data including power, voltage, and current.

• serial_number (required): Device serial number

ecoflow_set_ac_output

Enable or disable AC output on a power station.

• serial_number (required): Device serial number

• enabled (required): true to enable, false to disable

• xboost (optional): Enable X-Boost mode

• voltage (optional): Output voltage (110 or 220)

• frequency (optional): Output frequency (50 or 60 Hz)

ecoflow_set_dc_output

Enable or disable DC output (12V car port).

• serial_number (required): Device serial number

• enabled (required): true to enable, false to disable

ecoflow_get_charging_settings

Get current charging configuration.

• serial_number (required): Device serial number

ecoflow_set_charging_settings

Configure charging parameters.

• serial_number (required): Device serial number

• max_charge_soc (optional): Maximum charge level (0-100%)

• min_discharge_soc (optional): Minimum discharge level (0-100%)

• charging_watts (optional): AC charging power in watts

ecoflow_set_standby

Configure auto-standby timeouts.

• serial_number (required): Device serial number

• device_timeout (optional): Device standby timeout in minutes (0 = never)

• ac_timeout (optional): AC output timeout in minutes

• dc_timeout (optional): DC output timeout in minutes

• lcd_timeout (optional): LCD screen timeout in seconds

ecoflow_get_raw_quota

Get all raw device parameters (for debugging).

• serial_number (required): Device serial number

• filter (optional): Filter parameters by keyword

Example Usage

API Documentation

• EcoFlow Developer Platform

• API Introduction

License

MIT