OVO Energy MCP Server
dylword/ovo-energy-mcp
Conecte dados de energia OVO ao n8n via MCP
Ver no GitHubServidor MCP que expõe dados de consumo, gasto e pegada de carbono da OVO Energy como ferramentas para n8n. Integra a biblioteca Python comunitária ovoenergy para acessar dados de uso de energia, custos detalhados e intensidade de carbono da rede elétrica.
Instalação
npx convez-ai dylword/ovo-energy-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar relatórios de consumo de energia e custos em workflows n8n
- Integrar dados de pegada de carbono em dashboards de sustentabilidade
- Monitorar saldo de conta e gasto mensal de eletricidade/gás automaticamente
Veredito

Integração prática para usuários de n8n que precisam automatizar dados de energia OVO. Bem-documentado, mas depende de APIs internas não-oficiais que podem quebrar sem aviso — excelente para automações, requer monitoramento de estabilidade.
README
A tradução para o português deste README ainda está na fila.
OVO Energy MCP server
An MCP server that exposes OVO Energy data as tools for n8n (via the
MCP Client Tool node). Wraps the community
timmo001/ovoenergy Python client.
⚠️ OVO's APIs are unofficial/internal. They can change or break without notice, and data lags ~1 day (not real-time).
Tools
| Tool | What it returns |
|---|---|
ovo_half_hourly_usage(day?) | Half-hourly usage + cost for a day (default: yesterday) |
ovo_daily_usage(month?) | Daily usage + cost across a month (default: current month) |
ovo_spend_summary(month?) | Aggregated electricity/gas/total kWh + cost for a month |
ovo_accounts() | Active account id + customer id |
ovo_carbon_footprint() | Carbon footprint |
ovo_carbon_intensity() | Grid carbon intensity |
ovo_account_balance() | Account balance / billing (see note below) |
Billing note
The underlying library has no balance method (open upstream issue). The
ovo_account_balance tool calls OVO's internal GraphQL endpoint using the
authenticated session. If it errors, log in to my.ovoenergy.com, open browser
devtools → Network, find the balance request, and set these env vars to match:
OVO_BALANCE_URLOVO_BALANCE_QUERY
Daily/half-hourly cost is already included in the usage tools, so you get spend data without the balance endpoint.
Env vars
| Var | Required | Default |
|---|---|---|
OVO_USERNAME | yes | — |
OVO_PASSWORD | yes | — |
PORT | no | 8080 (Railway sets this) |
OVO_BALANCE_URL | no | OVO GraphQL endpoint |
OVO_BALANCE_QUERY | no | best-effort query |
Run locally
pip install -r requirements.txt
export OVO_USERNAME="you@example.com"
export OVO_PASSWORD="..."
python server.py
# MCP Streamable HTTP endpoint: http://localhost:8080/mcp
Deploy on Railway
- Push this folder to a repo (or
railway upfrom here). - New service from the repo → it builds the Dockerfile.
- Set
OVO_USERNAMEandOVO_PASSWORDin the service variables. - Generate a public domain. Your MCP endpoint is
https://<domain>/mcp.
Connect from n8n
- Add an MCP Client Tool node (or use it inside an AI Agent node).
- Connection type: HTTP Streamable.
- Endpoint URL:
https://<your-railway-domain>/mcp - The OVO tools above appear and can be called from your workflow / agent.