simplify-budget is an OpenClaw plugin package for running a personal budget tracker on top of a specific Google Sheets template.

It exposes an OpenClaw HTTP route and runs the bundled budget scripts directly. This package is for plugin installation, not skill-only installation.

It handles:

• expense create, find, update, delete
• income create, find, update, delete
• recurring item create, find, update, delete
• summary and cross-ledger lookup routes
• conversation preview/write/learn flows through the bundled bridge script

Required Sheet

This plugin only works with the Simplify Budget sheet template, or a direct copy of it:

• Simplify Budget Template

Each user must make their own copy of the sheet and configure their own Google service account credentials.

Optional browser UI for the same system:

• simplifybudget.com

The plugin talks to the Google Sheet directly. The web UI is optional.

What This Ships

This package contains:

• openclaw.plugin.json: plugin manifest
• index.js: plugin entrypoint
• scripts/: bundled budget scripts used by the plugin
• CONVERSATION_WORKFLOW.md: conversation-layer reference

Required Configuration

This plugin requires:

• GOOGLE_SA_FILE
• SPREADSHEET_ID
• TRACKER_CURRENCY

Optional:

• TRACKER_CURRENCY_SYMBOL

These values must point at a user-owned Google service account key and a user-owned copy of the Simplify Budget sheet template.

Security Scope

• The plugin talks to sheets.googleapis.com using the configured Google service account.
• It does not need or ship any session-pruning or agent-state migration tooling as part of the published plugin bundle.
• The Google service account should be scoped to Sheets access and shared only with the intended budget sheet.

Install Summary

• Copy the Google Sheet template.
• Create your own Google service account JSON key.
• Share the copied sheet with the service account email.
• Install this plugin package.
• Set the required environment variables.
• Restart OpenClaw.

Full instructions are in SETUP.md.