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

cd /Users/timothy.schwarz/Scripts/mcp-servers/ecoflow-mcp
npm install
npm run build

3. Configure MCP

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

{
  "ecoflow": {
    "type": "stdio",
    "command": "node",
    "args": ["/Users/timothy.schwarz/Scripts/mcp-servers/ecoflow-mcp/dist/index.js"],
    "env": {
      "ECOFLOW_ACCESS_KEY": "your_access_key_here",
      "ECOFLOW_SECRET_KEY": "your_secret_key_here"
    }
  }
}

Regional API

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

"env": {
  "ECOFLOW_ACCESS_KEY": "...",
  "ECOFLOW_SECRET_KEY": "...",
  "ECOFLOW_BASE_URL": "https://api-e.ecoflow.com"
}

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

> List my EcoFlow devices
> Show battery status for DELTA Pro (serial: R351...)
> Enable AC output on my DELTA 2
> Set charging limit to 80% on my power station
> Get solar panel input data

API Documentation

• EcoFlow Developer Platform

• API Introduction

License

MIT