Fronius Mcp

io.github.flowiesnerPublished by GitHub account flowiesnerv0.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyLocation & Lifestyle

Overview

AI-generated overview

Lets an assistant read live Fronius inverter data — solar generation, battery, grid and smart meter — from the local network.

What you can do
Connects to a Fronius inverter's local Solar API v1 and exposes tools for power flow, smart meter, battery and device data. Tools include configure_inverter to store the inverter's IP address, solar_power_flow for PV generation, grid exchange, house load, battery power, autonomy and energy totals, solar_meter for per-phase grid power and cumulative energy, solar_battery for state of charge, voltage, current, temperature and capacity, and solar_devices for connected device topology. Answers are based on data fetched at question time.
When to use it
Useful if you own a Fronius inverter with the Solar API enabled and want to ask an assistant natural-language questions about current generation, battery state, grid import or export, and energy totals, without a cloud account or subscription.
Requirements
A Fronius inverter on the local network with the Solar API (JSON API) enabled, Claude Desktop, and uv (a Python package manager) to run the PyPI package fronius-mcp via uvx. The inverter's IP address is configured once and stored in a local file. No cloud account, API key or environment variable is declared.
Before you install
The server reads from the inverter on the local network and stores the inverter's IP address in a local configuration file; the configure_inverter tool writes that setting. No credentials, payments or third-party data sharing are described.

Installation

In SourceWeft

  1. Open Fronius Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

fronius-mcp

[PyPI] [MCP Registry]

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:

PlatformPath
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

ToolWhat it does
configure_inverterSet your inverter's IP address — run this once on first setup
solar_power_flowPV generation, grid exchange, house load, battery power, autonomy, energy totals
solar_meterGrid power per phase, cumulative energy in/out, voltage, current, frequency
solar_batteryState of charge, voltage, current, temperature, capacity, status
solar_devicesAll 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.

Source: README.md at commit b049dc5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts