Skip to content
MCP server
Registry

Octopus Energy (octopus-mcp) MCP Server

Octopus Energy usage and costs, tariffs, Agile prices, bills, EV charging and Saving Sessions

Octopus Energy (octopus-mcp) scores 41 (Fair), licensed MIT and written in Go. It installs as a local process. It does not declare tools yet. Filed under Developer tools. GitHub shows 0 stars. Install configs are generated for 10 clients. Being listed in the registry is not the same as being vendor-official.

by mattoddieMITGo0 stars
Trust score
41Fair
Trust score 41 of 100, Fair

Fair trust

41 of 100 from six public signals. Nobody can buy a point.

  • OSI-style license: mit.
How we score trust
Scorecard

License, quality and maintenance

How grades work
Trust breakdown

Where the 41 comes from

0 + 20 + 0 + 10 + 4 + 7 = 41. Each factor is capped, so no single signal can carry a listing.

Registry0 / 30

Active in the official MCP registry, plus a known vendor namespace.

Registry: 0 of 30 points.
Maintenance20 / 20

How recently the repository saw a commit or release.

Maintenance: 20 of 20 points.
Popularity0 / 20

GitHub stars and weekly downloads, on a log scale.

Popularity: 0 of 20 points.
License10 / 10

A clear, OSI-style open-source license.

License: 10 of 10 points.
Security4 / 10

Not archived, a secure install path, a pinned version.

Security: 4 of 10 points.
Docs7 / 10

A real summary, a README with depth, listed tools.

Docs: 7 of 10 points.

Install

Pick your client, copy the config, paste it in.

Needs Cursor or VS Code installed on this device. The button opens the app and asks you to confirm before it adds the server.

~/Library/Application Support/Claude/claude_desktop_config.json
{  "mcpServers": {    "mattoddie-octopus-mcp": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "ghcr.io/mattoddie/octopus-mcp:0.3.1"      ],      "env": {        "MCP_TRANSPORT": "",        "OCTOPUS_API_KEY": "YOUR_OCTOPUS_API_KEY",        "OCTOPUS_ACCOUNT": "",        "OCTOPUS_ALLOW_WRITES": "false",        "OCTOPUS_TOOLSETS": "",        "OCTOPUS_AUDIT_LOG": ""      }    }  }}

Environment variables

NameRequiredNotes
MCP_TRANSPORTOptionalThe image serves HTTP by default; this runs it over stdio.
OCTOPUS_API_KEYSecretRequiredYour Octopus API key, from Personal details → API access in your Octopus account. It starts sk_live_.
OCTOPUS_ACCOUNTOptionalYour account number, like A-1234ABCD. Optional when the key can see only one account.
OCTOPUS_ALLOW_WRITESOptionaltrue lets the assistant change Intelligent Octopus charging and join Saving Sessions. false is read-only.
OCTOPUS_TOOLSETSOptionalComma-separated toolsets to expose: account, consumption, tariffs, intelligent, octoplus, raw. Empty means all.
OCTOPUS_AUDIT_LOGOptionalstderr, or a file path, to record every change the assistant makes as a JSON line. A file needs a volume.

Tools show up when the registry metadata or the repository README lists them. Public READMEs are read directly. A GitHub token is used only when one is already configured.

About

MCP server for Octopus Energy: smart meter usage, tariffs and Agile prices, bills, Intelligent Octopus and Saving Sessions from Claude and other AI assistants. Runs in Docker or as a one-click Claude Desktop bundle.

Frequently asked questions

What is Octopus Energy (octopus-mcp) MCP Server?

Octopus Energy usage and costs, tariffs, Agile prices, bills, EV charging and Saving Sessions

How do I install Octopus Energy (octopus-mcp) MCP Server in Claude Desktop, Cursor, or VS Code?

Pick your client in the Install section on this page and copy the generated config into the client's config file. Step-by-step guides: Claude Desktop, Cursor, and VS Code. Octopus Energy (octopus-mcp) MCP Server runs locally from the Docker image ghcr.io/mattoddie/octopus-mcp:0.3.1 with the command docker run -i --rm ghcr.io/mattoddie/octopus-mcp:0.3.1.

Is Octopus Energy (octopus-mcp) MCP Server free and open source?

Yes. Octopus Energy (octopus-mcp) MCP Server is released under the MIT license, an OSI-approved open-source license, so you can use, modify, and self-host it under those terms.

Does Octopus Energy (octopus-mcp) MCP Server support remote (HTTP) connections?

No remote endpoint is listed for Octopus Energy (octopus-mcp) MCP Server. It runs locally on your machine over stdio, started by your MCP client.

How is Octopus Energy (octopus-mcp) MCP Server's trust score calculated?

Octopus Energy (octopus-mcp) MCP Server scores 41 out of 100 (Fair). The score adds six capped public signals: registry status, maintenance, popularity, license, documentation, and security. Nobody can pay for points. Read the methodology for the full formula.

Reviews

No reviews yet

—Be the first to review

5 star0 reviews at 5 stars
4 star0 reviews at 4 stars
3 star0 reviews at 3 stars
2 star0 reviews at 2 stars
1 star0 reviews at 1 stars

No published reviews yet. Used it? Tell the next person how it went.

Add badge to your README

Paste either snippet into the repository README. The image links to this listing.

Listed on MCPpedia

Top 5 MCP servers

Daily or weekly. Confirm by email, unsubscribe any time.

How often

Manage this listing

Claim this server