Octopus Energy usage and costs, tariffs, Agile prices, bills, EV charging and Saving Sessions
Connect Runs on your machine
claude mcp add octopus-mcp -e MCP_TRANSPORT=<MCP_TRANSPORT> -e OCTOPUS_API_KEY=<OCTOPUS_API_KEY> -e OCTOPUS_ACCOUNT=<OCTOPUS_ACCOUNT> -e OCTOPUS_ALLOW_WRITES=<OCTOPUS_ALLOW_WRITES> -e OCTOPUS_TOOLSETS=<OCTOPUS_TOOLSETS> -e OCTOPUS_AUDIT_LOG=<OCTOPUS_AUDIT_LOG> -- docker run -i --rm ghcr.io/mattoddie/octopus-mcp:0.3.1{
"mcpServers": {
"octopus-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mattoddie/octopus-mcp:0.3.1"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"OCTOPUS_API_KEY": "<OCTOPUS_API_KEY>",
"OCTOPUS_ACCOUNT": "<OCTOPUS_ACCOUNT>",
"OCTOPUS_ALLOW_WRITES": "<OCTOPUS_ALLOW_WRITES>",
"OCTOPUS_TOOLSETS": "<OCTOPUS_TOOLSETS>",
"OCTOPUS_AUDIT_LOG": "<OCTOPUS_AUDIT_LOG>"
}
}
}
}{
"mcpServers": {
"octopus-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mattoddie/octopus-mcp:0.3.1"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"OCTOPUS_API_KEY": "<OCTOPUS_API_KEY>",
"OCTOPUS_ACCOUNT": "<OCTOPUS_ACCOUNT>",
"OCTOPUS_ALLOW_WRITES": "<OCTOPUS_ALLOW_WRITES>",
"OCTOPUS_TOOLSETS": "<OCTOPUS_TOOLSETS>",
"OCTOPUS_AUDIT_LOG": "<OCTOPUS_AUDIT_LOG>"
}
}
}
}{
"servers": {
"octopus-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/mattoddie/octopus-mcp:0.3.1"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"OCTOPUS_API_KEY": "<OCTOPUS_API_KEY>",
"OCTOPUS_ACCOUNT": "<OCTOPUS_ACCOUNT>",
"OCTOPUS_ALLOW_WRITES": "<OCTOPUS_ALLOW_WRITES>",
"OCTOPUS_TOOLSETS": "<OCTOPUS_TOOLSETS>",
"OCTOPUS_AUDIT_LOG": "<OCTOPUS_AUDIT_LOG>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MCP_TRANSPORTOptional | The image serves HTTP by default; this runs it over stdio. |
OCTOPUS_API_KEYRequired, secret | Your Octopus API key, from Personal details → API access in your Octopus account. It starts sk_live_. |
OCTOPUS_ACCOUNTOptional | Your account number, like A-1234ABCD. Optional when the key can see only one account. |
OCTOPUS_ALLOW_WRITESOptional | true lets the assistant change Intelligent Octopus charging and join Saving Sessions. false is read-only. |
OCTOPUS_TOOLSETSOptional | Comma-separated toolsets to expose: account, consumption, tariffs, intelligent, octoplus, raw. Empty means all. |
OCTOPUS_AUDIT_LOGOptional | stderr, or a file path, to record every change the assistant makes as a JSON line. A file needs a volume. |
Details
| Package | ghcr.io/mattoddie/octopus-mcp:0.3.1 (OCI, stdio) |
| Package | https://github.com/mattoddie/octopus-mcp/releases/download/v0.3.1/octopus-mcp-0.3.1-darwin-arm64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/octopus-mcp/releases/download/v0.3.1/octopus-mcp-0.3.1-darwin-amd64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/octopus-mcp/releases/download/v0.3.1/octopus-mcp-0.3.1-windows-amd64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/octopus-mcp/releases/download/v0.3.1/octopus-mcp-0.3.1-windows-arm64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/octopus-mcp/releases/download/v0.3.1/octopus-mcp-0.3.1-linux-amd64.mcpb (MCPB, stdio) |
| Package | https://github.com/mattoddie/octopus-mcp/releases/download/v0.3.1/octopus-mcp-0.3.1-linux-arm64.mcpb (MCPB, stdio) |
| First published | 22 Oct 2026 |
| Last updated | 22 Oct 2026 |
| Registry name | io.github.mattoddie/octopus-mcp |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.