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
- Register at EcoFlow Developer Platform
- Wait for approval (can take up to a week)
- 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 numberenabled(required): true to enable, false to disablexboost(optional): Enable X-Boost modevoltage(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 numberenabled(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 numbermax_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 numberdevice_timeout(optional): Device standby timeout in minutes (0 = never)ac_timeout(optional): AC output timeout in minutesdc_timeout(optional): DC output timeout in minuteslcd_timeout(optional): LCD screen timeout in seconds
ecoflow_get_raw_quota
Get all raw device parameters (for debugging).
serial_number(required): Device serial numberfilter(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
License
MIT