io.github.flowiesner/fronius-mcp

Official

by flowiesner · Python

Real-time Fronius inverter data in Claude — PV, battery, grid and smart meter via local Solar API.

Streams real-time Fronius solar inverter data for PV, battery, grid, and smart meters.

Topics

fronius-solar-apimcp-serverphotovoltaicsmarthomefroniusinverternatural-language-understandinghome-automationmodel-context-protocol

README.md5 KBView on GitHub

fronius-mcp

Real-time solar data from your Fronius inverter, directly in Claude.

Ask things like:

"How much solar power am I generating right now?"

"What's my battery charge level?"

"Am I currently importing or exporting to the grid?"

"How much energy did I produce this year?"

"What can you do with my solar system?"

"Analyse my photovoltaics for me."

Connects to the Fronius Solar API v1 directly on your local network — no cloud account, no subscription, no data leaving your home.

How it works

fronius-mcp is a Model Context Protocol (MCP) server. MCP is an open standard that lets AI assistants like Claude connect to external tools and data sources. Once configured, Claude can call your inverter's local API in real time — whenever you ask a question about your solar system, Claude fetches live data and answers based on what's actually happening right now.

Requirements

A Fronius inverter on your local network with the Solar API (JSON API) enabled
Claude Desktop
uv — a fast Python package manager (one-line install)

Setup

1. Install uv

uv is a fast Python package manager used to run fronius-mcp without a permanent install.

macOS / Linux:

bash

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell

irm https://astral.sh/uv/install.ps1 | iex

Restart your terminal after installing.

2. Add to Claude Desktop

Open your claude_desktop_config.json and add the fronius block inside mcpServers:

json

{
  "mcpServers": {
    "fronius": {
      "command": "uvx",
      "args": ["fronius-mcp"]
    }
  }
}

Config file location:

Platform	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Windows (Store app)	`%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json`

Tip: If the mcpServers key already exists, just add the fronius block inside it — don't create a second mcpServers.

3. Restart Claude Desktop

Close and reopen Claude Desktop so it picks up the new server config.

4. Configure your inverter

In a new Claude conversation, say:

"Configure my Fronius inverter at 192.168.178.35"

Claude will save your inverter's IP and confirm the connection. This is a one-time step — the address is stored in ~/.fronius-mcp.json and persists across restarts.

Don't know your inverter's IP? Tell Claude: "I want to configure my Fronius inverter but I don't know the IP." Claude will walk you through finding it via your router, Fronius Solar.web, or the inverter's touch display — and how to enable the Solar API in the inverter's web interface if you haven't done that yet.

What you can ask

Once set up, just talk to Claude naturally. Some examples:

"What's my current solar output?" — live PV generation in watts
"How self-sufficient am I right now?" — autonomy and self-consumption percentages
"Is my battery charging or discharging?" — battery power flow and state of charge
"How much have I fed into the grid today?" — energy totals from the smart meter
"What devices are connected to my inverter?" — full system topology
"Give me a full overview of my solar system." — Claude combines all data sources into a summary

Tools

Tool	What it does
`configure_inverter`	Set your inverter's IP address — run this once on first setup
`solar_power_flow`	PV generation, grid exchange, house load, battery power, autonomy, energy totals
`solar_meter`	Grid power per phase, cumulative energy in/out, voltage, current, frequency
`solar_battery`	State of charge, voltage, current, temperature, capacity, status
`solar_devices`	All connected devices with type, bus index, and serial number

Compatible Hardware

Developed and tested on:

Fronius Symo GEN24 10.0 Plus
BYD Battery-Box Premium HV (13.824 kWh)
Fronius Smart Meter (grid feed-in point, 3-phase)

Other Fronius inverters with Solar API v1 support should work. Some API endpoints behave differently across models — if something doesn't work on your hardware, open an issue.

License

Apache 2.0 — see LICENSE.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "fronius-mcp": {
      "command": "uvx",
      "args": [
        "fronius-mcp"
      ]
    }
  }
}