maybe-finance

What This Skill Does

The maybe-finance skill serves as a comprehensive interface for the Maybe Finance open-source personal finance operating system. By integrating your self-hosted Maybe instance with OpenClaw, this agent acts as your private financial secretary. It enables real-time tracking of assets, liabilities, income, and expenditures. The skill provides direct programmatic access to account balances, allows for the manual ingestion of transaction data, and performs deep-dive analytics into your monthly budget performance. Whether you are tracking a single checking account or managing a complex net-worth portfolio, this skill allows you to query your financial data using natural language, making personal finance management intuitive and actionable without needing to manually navigate a dashboard.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/antonia-sz/maybe-finance. After installation, ensure you have a running Maybe Finance Docker container reachable via your local network. You must generate an API key from the Settings panel of your Maybe dashboard and configure the environment variables MAYBE_API_URL and MAYBE_API_TOKEN within your OpenClaw environment. These credentials ensure the agent can securely interact with your local instance without exposing your financial data to third-party clouds.

Use Cases

• Automated Expense Logging: Quickly record daily purchases by voice or text while on the go.
• Budget Compliance Monitoring: Regularly check if you are meeting your savings or spending targets mid-month.
• Portfolio Monitoring: Assess net worth fluctuations by querying account balances across various banking and investment institutions.
• Tax and Periodic Reporting: Generate aggregated spending reports for specific categories to simplify annual tax preparation.

Example Prompts

1. "Check my current budget status for this month and let me know if I am overspending in the dining category."
2. "Add a new expense of $45 for gas under the transportation category and link it to my main credit card."
3. "What is my total net worth right now, and how has it changed compared to January?"

Tips & Limitations

This skill requires a self-hosted instance, meaning its availability depends on your server uptime. For the best experience, ensure your Maybe instance is updated to the latest version to maintain compatibility with the API. While the skill is powerful for manual entry and analysis, note that it currently does not support automatic bank syncing via third-party providers (like Plaid) directly through the CLI; that configuration must be handled within the Maybe Finance web interface. Use the JSON output format for any advanced scripts you might write to pipe financial data into other tools.