How to integrate Electricity Maps MCP with Hermes

Connect Hermes to Electricity Maps MCP. Check current carbon intensity in california, compare renewable energy across european zones, and more using natural language, with authentication handled for you.

Electricity Maps logoElectricity Maps
Api Key

Electricity Maps is a data service for grid carbon intensity, power mix, and energy market data. It helps teams track emissions, renewable energy, power flows, and prices by zone.

49 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Electricity Maps account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Electricity Maps with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Electricity Maps with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Electricity Maps

Ask your agent to connect to Electricity Maps, or simply request any Electricity Maps-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Electricity Maps connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Electricity Maps or request any Electricity Maps-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Electricity Maps MCP server, and what's possible with it?

The Electricity Maps MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Electricity Maps account. It provides structured and secure access to grid carbon intensity, electricity mix, power flows, load, energy shares, forecasts, and day-ahead prices, so your agent can monitor grid conditions, compare historical energy data, review future forecasts, and analyze electricity costs on your behalf.

  • Carbon intensity monitoring: Have your agent check the latest, historical, or past carbon intensity for a zone, including grid-average and fossil-only values.
  • Energy mix and renewable analysis: Let the agent review current, historical, and forecasted electricity generation by source, along with carbon-free and renewable energy shares.
  • Grid flow and load tracking: Direct your agent to examine electricity flows and net, total, or total-reported load for a zone across current, historical, past, and forecast periods.
  • Grid condition forecasting: Instruct your agent to assess forecasted carbon intensity, carbon-free percentages, renewable percentages, electricity mix, flows, source generation, energy shares, and load.
  • Day-ahead price research: Have your agent retrieve current, historical, past, or actual day-ahead prices for a zone or locational marginal prices for a pricing node over a selected time range.

Way Forward

With Electricity Maps connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Electricity Maps action and event your agent gets out of the box.

Get Carbon Intensity Forecast

Get a grid-average or fossil-only carbon intensity forecast for a zone.

Get Carbon Intensity History

Get the last 24 hours of grid-average or fossil-only carbon intensity for a zone.

Get Carbon Intensity Latest

Get the latest grid-average or fossil-only carbon intensity for a zone.

Get Carbon Intensity Past

Get grid-average or fossil-only carbon intensity for a zone at a given datetime.

Get Carbon Intensity Past Range

Get grid-average or fossil-only carbon intensity for a zone over a datetime range.

Get Electricity Flows Forecast

Get the electricity flows forecast for a zone.

Get Electricity Flows History

Get the last 24 hours of electricity flows for a zone.

Get Electricity Flows Latest

Get the latest electricity flows for a zone.

Get Electricity Flows Past

Get the electricity flows for a zone at a given datetime.

Get Electricity Flows Past Range

Get the electricity flows for a zone and a given datetime range.

Get Electricity Mix Forecast

Get the electricity mix forecast for a zone.

Get Electricity Mix History

Get the last 24 hours of electricity mix for a zone.

Get Electricity Mix Latest

Get the latest electricity mix for a zone.

Get Electricity Mix Past

Get the electricity mix for a zone at a given datetime.

Get Electricity Mix Past Range

Get the electricity mix for a zone and a given datetime range.

Get Electricity Source Forecast

Get forecasted electricity generation values for the selected source_type in a zone.

Get Electricity Source History

Get the last 24 hours of electricity generation values for the selected source_type in a zone.

Get Electricity Source Latest

Get the latest electricity generation values for the selected source_type in a zone.

Get Electricity Source Past

Get electricity generation values for the selected source_type in a zone at a given datetime.

Get Electricity Source Past Range

Get electricity generation values for the selected source_type in a zone over a given datetime range.

Get Energy Share Forecast

Get the carbon-free or renewable electricity share forecast for a zone.

Get Energy Share History

Get the last 24 hours of carbon-free or renewable electricity share for a zone.

Get Energy Share Latest

Get the latest carbon-free or renewable electricity share for a zone.

Get Energy Share Past

Get the carbon-free or renewable electricity share at a given datetime.

Get Energy Share Past Range

Get carbon-free or renewable electricity share values over a datetime range.

Get Grid Level Forecast

Get forecasted carbon-intensity, carbon-free-percentage, or renewable-percentage grid levels.

Get Grid Level Latest

Get the latest carbon-intensity, carbon-free-percentage, or renewable-percentage grid level.

Get Grid Level Past

Get a carbon-intensity, carbon-free-percentage, or renewable-percentage grid level for an exact past hourly bucket.

Get Grid Level Past Range

Get carbon-intensity, carbon-free-percentage, or renewable-percentage grid levels over an hourly range of at most 10 days.

Get Load Forecast

Get a net, total, or total-reported electricity load forecast.

Get Load History

Get the last 24 hours of net, total, or total-reported load.

Get Load Latest

Get the latest net, total, or total-reported electricity load value.

Get Load Past

Get net, total, or total-reported load at a given datetime.

Get Load Past Range

Get net, total, or total-reported load over a datetime range.

Get Day-Ahead Locational Marginal Price Actual

Get actual day-ahead locational marginal prices for a pricing node and datetime range.

Get Day-Ahead Locational Marginal Price History

Get the last 24 hours of day-ahead locational marginal prices for a pricing node.

Get Day-Ahead Locational Marginal Price Latest

Get the latest day-ahead locational marginal price for a pricing node.

Get Day-Ahead Locational Marginal Price Past

Get the day-ahead locational marginal price for a pricing node at a given datetime.

Get Day-Ahead Locational Marginal Price Past Range

Get day-ahead locational marginal prices for a pricing node and past datetime range of at most 10 days.

Get Day-Ahead Price Actual

Get settled and published day-ahead prices for a zone and datetime range.

Get Day-Ahead Price Combined

Get both actual and forecasted day-ahead prices for a zone in a single response.

Get Day-Ahead Price Forecast

Get the day-ahead price forecast for a zone.

Get Day-Ahead Price History

Get the last 24 hours of day-ahead price for a zone.

Get Day-Ahead Price Latest

Get the latest day-ahead price for a zone.

Get Day-Ahead Price Past

Get the day-ahead price for a zone at a given datetime.

Get Day-Ahead Price Past Range

Get the day-ahead price for a zone and a given datetime range.

Get Zone

Get metadata for a single Electricity Maps zone.

List Updates Since

List data points for a zone that have been updated since a given datetime.

List Zones

List all commercially available Electricity Maps zones.

FAQ

Frequently asked questions

Start with Electricity Maps.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Electricity Maps tool your agent needs.Free to start.

Start building