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.
Fair trust
41 of 100 from six public signals. Nobody can buy a point.
- OSI-style license: mit.
License, quality and maintenance
Quality: Grade D
48/100 for listing completeness. Lost points: short README, no listed tools, short summary.
How quality is graded
Where the 41 comes from
0 + 20 + 0 + 10 + 4 + 7 = 41. Each factor is capped, so no single signal can carry a listing.
Active in the official MCP registry, plus a known vendor namespace.
Registry: 0 of 30 points.How recently the repository saw a commit or release.
Maintenance: 20 of 20 points.GitHub stars and weekly downloads, on a log scale.
Popularity: 0 of 20 points.A clear, OSI-style open-source license.
License: 10 of 10 points.Not archived, a secure install path, a pinned version.
Security: 4 of 10 points.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.
{ "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
| Name | Required | Notes |
|---|---|---|
MCP_TRANSPORT | Optional | The image serves HTTP by default; this runs it over stdio. |
OCTOPUS_API_KEYSecret | Required | Your Octopus API key, from Personal details → API access in your Octopus account. It starts sk_live_. |
OCTOPUS_ACCOUNT | Optional | Your account number, like A-1234ABCD. Optional when the key can see only one account. |
OCTOPUS_ALLOW_WRITES | Optional | true lets the assistant change Intelligent Octopus charging and join Saving Sessions. false is read-only. |
OCTOPUS_TOOLSETS | Optional | Comma-separated toolsets to expose: account, consumption, tariffs, intelligent, octoplus, raw. Empty means all. |
OCTOPUS_AUDIT_LOG | Optional | stderr, or a file path, to record every change the assistant makes as a JSON line. A file needs a volume. |
Tools
All capabilitiesTools 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
No published reviews yet. Used it? Tell the next person how it went.
Sign inA verified email is required to review this server.
Add badge to your README
Paste either snippet into the repository README. The image links to this listing.
