Real-time Fronius inverter data in Claude — PV, battery, grid and smart meter via local Solar API.
About
Real-time Fronius inverter data in Claude — PV, battery, grid and smart meter via local Solar API.
Security Report
Valid MCP server (1 strong, 3 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
11 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-flowiesner-fronius-mcp": {
"args": [
"fronius-mcp"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (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:
{
"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
mcpServerskey already exists, just add thefroniusblock inside it — don't create a secondmcpServers.
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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption