EcoFlow

You can manage EcoFlow power stations from a single MCP server that exposes device status, output controls, charging settings, standby timeouts, and raw parameters for debugging. This MCP server consolidates EcoFlow device data and control capabilities into an approachable interface you can automate or monitor from your preferred MCP client.

How to use

Connect to the EcoFlow MCP server using your MCP client and the standard tools exposed by the server. You can list all linked EcoFlow devices, fetch their current status, monitor solar input, and control AC/DC outputs as well as charging and standby settings. Use the available tool names to perform actions, for example listing devices, checking a device’s status, or adjusting charging limits. These operations are designed to be practical for day-to-day monitoring and remote control, without needing to dive into low‑level protocol details.

How to install

Prerequisites you need installed on your system before you begin:

• Node.js (version 12 or higher)
• npm (comes with Node.js)

Step-by-step setup you can follow to prepare and run the EcoFlow MCP server locally:

# 1. Ensure Node and npm are installed
node -v
npm -v

# 2. Install dependencies for the EcoFlow MCP server
cd /path/to/ecoflow-mcp
npm install

# 3. Build the server bundle (if the project requires a build step)
npm run build

# 4. Configure your MCP client to expose EcoFlow as an MCP server

After installing and building, you need to configure your MCP client with the EcoFlow MCP server entry described in the configuration section below.

## Additional sections

Configuration, security, and example usage help you tailor the server to your environment.

## Configuration and usage notes

Configure your MCP client to connect to the EcoFlow MCP server using the following local configuration. This example shows how to expose the local server that runs a Node.js script to interact with EcoFlow devices.

{ "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" } } }

To use the regional API, include the base URL in the environment:

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

Save this configuration to your MCP client’s config store so your client can start the EcoFlow MCP server automatically on launch.

Available tools

ecoflow_list_devices

List all EcoFlow devices linked to your account.

ecoflow_get_device_status

Retrieve comprehensive status for a specific device including battery level, power flow, and temperatures.

ecoflow_get_solar_input

Fetch solar panel input data such as power, voltage, and current for a device.

ecoflow_set_ac_output

Enable or disable AC output with optional X-Boost mode, voltage, and frequency settings.

ecoflow_set_dc_output

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

ecoflow_get_charging_settings

Retrieve current charging configuration for a device.

ecoflow_set_charging_settings

Configure charging parameters including max/min SOC and charging power.

ecoflow_set_standby

Configure auto-standby timeouts for device, AC, DC, and LCD.

ecoflow_get_raw_quota

Retrieve all raw device parameters for debugging.