Aivy Energy
Ask an AI assistant about your home solar battery and let it set the energy mode
- Pricing
- Open source
- Platforms
- macOS, Linux, CLI
- Runs
- Locally
- Version
- 0.9.2
- Listing updated
- 3 days ago
About Aivy Energy
Aivy Energy is an open-source MCP server for energy and smart home. It runs locally on your machine and is started by your AI client.
Built for home solar and battery systems in Australia, this server reaches Sungrow, Sigenergy, FoxESS, AlphaESS and SolaX hardware through the Aivy Developer API by Ivy Energy, with the same tools whatever the inverter. It also plans around Amber Electric prices, so you can ask when to sell tonight while keeping 20% in reserve, or why the battery charged at 3 am.
Control is deliberately limited. A forced mode set through the API is time-boxed and hands back to the previous mode when it ends, the state-of-charge floor and export limits cannot be overridden by any call, and read-only keys cannot change anything. Every call is logged against the key that made it. Keys can be restricted to chosen sites and revoked.
You can start without hardware: every key lists demo sites with replayed real data, and changes on them never reach a device. The server runs locally through uvx aivy-mcp@latest, and can create an account from the chat, storing the key in a file only you can read. The developer site lists Apache 2.0.
Install
Run in a terminal
claude mcp add aivy-mcp --env AIVY_API_KEY='<AIVY_API_KEY>' -- uvx aivy-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"aivy-mcp": {
"command": "uvx",
"args": [
"aivy-mcp"
],
"env": {
"AIVY_API_KEY": "<AIVY_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"aivy-mcp": {
"command": "uvx",
"args": [
"aivy-mcp"
],
"env": {
"AIVY_API_KEY": "<AIVY_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"aivy-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"aivy-mcp"
],
"env": {
"AIVY_API_KEY": "<AIVY_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"aivy-mcp": {
"command": "uvx",
"args": [
"aivy-mcp"
],
"env": {
"AIVY_API_KEY": "<AIVY_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"aivy-mcp": {
"command": "uvx",
"args": [
"aivy-mcp"
],
"env": {
"AIVY_API_KEY": "<AIVY_API_KEY>"
}
}
}
}Configuration
AIVY_API_KEYPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.AIVY_API_URLAPI base URL. Default https://bridge.ivyenergy.com.au/v1
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- get_status
- Shows what the battery is doing right now.
- get_prices
- Returns upcoming Amber prices.
- plan_best_price_discharge
- Plans when to sell while keeping a reserve.
- set_energy_mode
- Sets a forced, time-boxed energy mode.
- get_operations
- Explains past battery operations.
- create_alert
- Creates an alert such as a low battery level.
- list_vendors
- Lists supported inverter brands.
- connect_site
- Connects a solar system.
- get_agent_guide
- Returns the agent playbook.
What it does
- Battery status
- Shows what the battery is doing right now.
- Amber price planning
- Reads upcoming prices and plans the best time to discharge.
- Time-boxed control
- Forced modes expire and return the site to its earlier mode.
- Alerts
- Creates alerts such as battery level dropping below a threshold.
- Demo sites
- Try every tool on replayed data before owning hardware.
- Scoped API keys
- Keys can be read-only, site-limited and revocable.
Good for
- Check what a home battery is doing
- Plan when to sell stored energy at peak prices
- Charge the battery to a set level within a time window
- Find out why the battery charged overnight
- Get alerted when charge drops below 20%
Pricing
Open source
Apache 2.0 per the developer site
Prices change. Check bridge.ivyenergy.com.au before you buy.
Aivy Energy FAQ
Which inverter brands work?
Sungrow, Sigenergy, FoxESS, AlphaESS and SolaX.
Do I need an API key to start?
No. Without one, the assistant can register an account or sign in from the chat and store the key locally.
Can the assistant damage my battery settings?
The site says forced modes are time-boxed and the state-of-charge floor and export limits cannot be overridden.
Can I try it without a battery?
Yes. Every key also sees demo sites with replayed real data.
Is Aivy Energy free?
Yes. Aivy Energy is open source, so you can use and self-host it for free.
How do I add Aivy Energy to Claude Code?
Run this command in your terminal: claude mcp add aivy-mcp --env AIVY_API_KEY='<AIVY_API_KEY>' -- uvx aivy-mcp
What are the best alternatives to Aivy Energy?
The closest alternatives to Aivy Energy are myIO, THRIVE Fleet Intelligence, Spark Pack, ElectricityFinder and (iS)NEPI - National Energy Performance Index.
Alternatives to Aivy Energy
myIO
MCP serverAsk Claude about and control a myIO smart home controller: heating, blinds, lighting
Runs locally- 1 tool
- Open source
- Smart home
THRIVE Fleet Intelligence
MCP serverFree no-key MCP server with UK fleet data: fuel prices, EV charging, company car tax
- 15 tools
- Remote
- Free
- Energy and smart home
Spark Pack
MCP serverFree MCP tools for UK electricians: cable sizing, Part P, certificate checks and G98/G99
- 7 tools
- Remote
- Free
- Home services

ElectricityFinder
MCP serverRank Texas electricity plans by yearly cost at your own monthly usage
- 3 tools
- Remote
- Freemium
- Energy and smart home

Country energy-market bands with cited evidence, read-only for iSolOS subscribers
Not checked yet- Remote
- Paid
- Energy and smart home

Barrio Grid
MCP serverTexas grid siting data: substations, ERCOT prices, queue, parcels, water and permits
Not checked yet- 6 tools
- Remote
- Freemium
- Energy and smart home