OpenSkillIndex← back to search
claude-codeopenclawfinance

Skills maybe-finance

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.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/antonia-sz/maybe-finance" ~/.claude/skills/openclaw-skills-maybe-finance && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/antonia-sz/maybe-finance" ~/.openclaw/skills/openclaw-skills-maybe-finance && rm -rf "$T"
manifest: skills/antonia-sz/maybe-finance/SKILL.md
tags
#finance#api-integration#data-management#budgeting#transaction-tracking
source content

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

  1. Self-hosted Maybe instance - Deploy via Docker: 
    docker run -d -p 3000:3000 ghcr.io/maybe-finance/maybe:latest
  2. 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-31

Budget 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-03

Net Worth & Reports

# Current net worth snapshot
maybe-finance networth

# Cash flow report
maybe-finance cashflow --period monthly

# Generate financial summary
maybe-finance summary --year 2024

Scripts

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