Log inSubmit server
Fronius MCP logo

Fronius MCP

Reads live Fronius inverter, battery, grid, and smart-meter data through local MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Fronius MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "fronius-mcp": {
      "command": "uvx",
      "args": [
        "fronius-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx fronius-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 3d ago.

Overview

The fronius-mcp MCP server connects an AI assistant to the Fronius Solar API v1 on a local network. It provides tools for configuring an inverter, reading live power flow, inspecting smart-meter and battery measurements, and listing connected devices. Reach for it when you want conversational access to current PV production, grid exchange, energy totals, or battery status without a cloud account.

Use cases

  • Check current photovoltaic output
  • Monitor battery charge and discharge
  • Compare grid import and export
  • Review smart-meter energy totals
  • List connected inverter devices

Key features

  • Local Fronius Solar API v1 access
  • Real-time PV and household power-flow readings
  • Battery status and electrical measurements
  • Three-phase smart-meter data
  • Connected-device inventory
  • Persistent inverter IP configuration

Tools5

What Fronius MCP lets your agent do. Expand a tool for its parameters.

Self-reported~103 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 47d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 19h ago via OSV.dev · fronius-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit6mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed5Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Fronius MCP works

What fronius-mcp MCP server does

The fronius-mcp MCP server exposes data from a Fronius inverter through the Model Context Protocol. It is intended for solar installations where an AI assistant needs current operating information from the local network. The server can report photovoltaic generation, household consumption, grid import or export, battery activity, autonomy, self-consumption, and energy totals.

It also exposes smart-meter readings, including per-phase grid power, cumulative energy entering or leaving the system, voltage, current, and frequency. Battery queries include state of charge, voltage, current, temperature, capacity, and status. A device inventory tool returns connected equipment with its type, bus index, and serial number.

How it works

The server calls Fronius Solar API v1 directly on the local network. After the inverter address is configured, an MCP-compatible assistant can request current data when a user asks about the solar system. The data path remains local according to the project documentation; a cloud account or subscription is not required, and the inverter readings do not need to leave the home network for this connection.

The initial configuration uses configure_inverter to save the inverter IP address. That address is stored in ~/.fronius-mcp.json, so it persists when the server is restarted. The remaining tools query different parts of the installation as needed.

Setup and configuration

The documented setup targets Claude Desktop and uses uvx to run the package without a permanent installation. Install uv, add a fronius entry under mcpServers in Claude Desktop's configuration, and restart Claude Desktop. The configured command is uvx with fronius-mcp as its argument.

The inverter must be reachable on the local network and have its Solar API, also called the JSON API, enabled. In a new conversation, provide the inverter's IP address through the configuration tool. If the address is unknown, the project documentation suggests finding it through the router, Fronius Solar.web, or the inverter's touch display, and checking the inverter web interface for API enablement.

Tools and capabilities

  • configure_inverter: Saves the inverter IP address for later requests.
  • solar_power_flow: Reports PV output, grid exchange, house load, battery power, autonomy, and energy totals.
  • solar_meter: Returns per-phase grid power, cumulative import and export energy, voltage, current, and frequency.
  • solar_battery: Reports battery charge level, electrical readings, temperature, capacity, and status.
  • solar_devices: Lists connected devices with their type, bus index, and serial number.

Limitations and notes

The project was developed and tested with a Fronius Symo GEN24 10.0 Plus, a BYD Battery-Box Premium HV battery, and a three-phase Fronius Smart Meter at the grid feed-in point. Other Fronius inverters supporting Solar API v1 may work, but the documentation notes that API endpoints can differ between models.

This server depends on local network access to the inverter and on the Solar API being enabled. If a particular endpoint behaves differently on the installed hardware, the project recommends reporting the issue to its repository.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Fronius MCP

fronius-mcp is an MCP server that connects an AI assistant to a Fronius inverter's local Solar API v1. Its main tools configure the inverter, read power flow, inspect smart-meter measurements, report battery state, and list connected devices. It provides live PV, grid, load, battery, and energy data without requiring a cloud account or subscription.

Install uv, add the documented uvx command to Claude Desktop's mcpServers configuration, and restart Claude Desktop. The configuration runs fronius-mcp through uvx, so a permanent package installation is not required.

Use the configure_inverter tool with the inverter's local IP address. The address is saved in ~/.fronius-mcp.json and remains available after restarts. The inverter must have Solar API v1 enabled and be reachable on the local network.

Because the project uses MCP over a standard command-based configuration, using it with another MCP client depends on that client's support for configuring stdio servers.

Related MCP servers

All in Industrial & IoT All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFronius MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/fronius-mcp?style=directory)](https://allmcps.com/mcp/fronius-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/fronius-mcp"><img src="https://allmcps.com/api/badge/fronius-mcp?style=directory" alt="Fronius MCP on AllMCPs" /></a>