- name
- maybe-finance
- description
- Personal finance management skill using Maybe Finance OS. Use when users need to track expenses, analyze budgets, monitor net worth, or manage personal finances through the Maybe Finance self-hosted platform. Supports transaction tracking, account management, budget analysis, and financial reporting.
Maybe Finance Skill
Personal finance management powered by Maybe Finance - an open-source personal finance OS.
Overview
Maybe Finance is a self-hosted personal finance platform for tracking:
- Transactions - Income and expenses
- Accounts - Bank accounts, investments, loans
- Budgets - Monthly spending targets
- Net Worth - Assets minus liabilities over time
- Cash Flow - Income vs expenses analysis
Prerequisites
- Self-hosted Maybe instance - Deploy via Docker:
docker run -d -p 3000:3000 ghcr.io/maybe-finance/maybe:latest- API Token - Generate in Maybe UI: Settings → API Keys
Configuration
Set environment variables:
export MAYBE_API_URL="http://localhost:3000"
export MAYBE_API_TOKEN="your-api-token"Usage
Account Management
# List all accounts
maybe-finance accounts list
# Add a new account
maybe-finance accounts add --name "Alipay" --type checking --balance 5000
# Update account balance
maybe-finance accounts update <account-id> --balance 6000
# Delete account
maybe-finance accounts delete <account-id>Transaction Tracking
# List recent transactions
maybe-finance transactions list --limit 20
# Add income
maybe-finance transactions add --amount 10000 --type income --category "工资" --description "三月工资"
# Add expense
maybe-finance transactions add --amount -150 --type expense --category "餐饮" --description "午餐"
# Search transactions
maybe-finance transactions search --category "餐饮" --from 2024-01-01 --to 2024-03-31Budget Analysis
# View current month budget
maybe-finance budget current
# Analyze spending by category
maybe-finance budget analyze --month 2024-03
# Compare months
maybe-finance budget compare --from 2024-01 --to 2024-03Net Worth & Reports
# Current net worth snapshot
maybe-finance networth
# Cash flow report
maybe-finance cashflow --period monthly
# Generate financial summary
maybe-finance summary --year 2024Scripts
All functionality is available through scripts/maybe-cli.py:
- Handles API authentication
- Formats output for readability
- Supports JSON export for further processing
Integration Ideas
- Connect with CSV import skill for bulk transaction entry
- Schedule daily/weekly financial reports via cron
- Export data for tax preparation
- Alert on budget overruns