← Back to Skills Marketplace
mayswind

ezBookkeeping API Tools

by mayswind · GitHub ↗ · v1.3.0 · MIT-0
cross-platform ✓ Security Clean
2415
Downloads
2
Stars
9
Active Installs
4
Versions
Install in OpenClaw
/install ezbookkeeping
Description
Use ezBookkeeping API Tools script to record new transactions, query transactions, retrieve account information, retrieve categories, retrieve tags, and retr...
README (SKILL.md)

ezBookkeeping API Tools

Usage

List all supported commands

Linux / macOS

sh scripts/ebktools.sh list

Windows

scripts\ebktools.ps1 list

Show help for a specific command

Linux / macOS

sh scripts/ebktools.sh help \x3Ccommand>

Windows

scripts\ebktools.ps1 help \x3Ccommand>

Call API

Linux / macOS

sh scripts/ebktools.sh [global-options] \x3Ccommand> [command-options]

Windows

scripts\ebktools.ps1 [global-options] \x3Ccommand> [command-options]

Troubleshooting

If the script reports that the environment variable EBKTOOL_SERVER_BASEURL or EBKTOOL_TOKEN is not set, user can define them as system environment variables, or create a .env file in the user home directory that contains these two variables and place it there.

The meanings of these environment variables are as follows:

Variable Required Description
EBKTOOL_SERVER_BASEURL Required ezBookkeeping server base URL (e.g., http://localhost:8080)
EBKTOOL_TOKEN Required ezBookkeeping API token

Reference

ezBookkeeping: https://ezbookkeeping.mayswind.net

Usage Guidance
This skill appears coherent for interacting with an ezBookkeeping server: it only needs a server base URL and an API token. Before installing or running it, open and read scripts/ebktools.sh in full (it is included) to verify there are no unexpected network endpoints, telemetry, or code that reads unrelated files. Note the SKILL.md mentions a Windows PowerShell script (scripts/ebktools.ps1) that is not present in the manifest — if you need Windows support, ask the publisher or inspect the missing file. Keep your EBKTOOL_TOKEN scoped/minimal (rotate it if possible) and avoid placing highly privileged credentials in a .env file in a shared/home directory unless you trust the environment. If you find any hardcoded external URLs or code that sends data to hosts other than your EBKTOOL_SERVER_BASEURL, do not run the script and report the finding.
Capability Analysis
Type: OpenClaw Skill Name: ezbookkeeping Version: 1.3.0 The ezbookkeeping skill bundle provides a comprehensive CLI tool (ebktools.sh) for interacting with the ezBookkeeping API. The script is well-structured, includes detailed API configurations, dependency checks, and helper functions for formatting JSON responses into Markdown tables. While it searches for environment variables in a generic '.env' file within the user's home directory (scripts/ebktools.sh), this behavior is explicitly documented in SKILL.md and the script only extracts specific, relevant keys (EBKTOOL_TOKEN and EBKTOOL_SERVER_BASEURL). No evidence of malicious intent, data exfiltration, or high-risk vulnerabilities was found.
Capability Assessment
Purpose & Capability
Name/description match the declared requirements (EBKTOOL_SERVER_BASEURL and EBKTOOL_TOKEN) and the shipped script implements API calls for ezBookkeeping endpoints. The requested env vars are appropriate for a client of a self‑hosted API.
Instruction Scope
SKILL.md instructs the agent/user to run scripts/ebktools.sh (Linux/macOS) and references a PowerShell counterpart for Windows; the package only contains the shell script (scripts/ebktools.sh). The README/troubleshooting suggests placing a .env file in the user home directory — the script will therefore read environment variables or allow storing them in ~/.env, which is normal but means it may access files in the user home. Review the full shell script for any unexpected file reads, hidden endpoints, or network calls beyond the provided server base URL.
Install Mechanism
No install spec — instruction-only with an included shell script. No downloads, package installs, or archive extraction are declared.
Credentials
Only EBKTOOL_SERVER_BASEURL and EBKTOOL_TOKEN are required (primaryEnv is EBKTOOL_TOKEN). These are appropriate and proportional for a client that talks to a bookkeeping API; no unrelated credentials or broad environment access is requested.
Persistence & Privilege
always is false and the skill does not request persistent/system‑wide configuration or elevated privileges. The agent may invoke it autonomously (platform default), which is expected for skills.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ezbookkeeping
  3. After installation, invoke the skill by name or use /ezbookkeeping
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.0
- Removed use of eval in posix scripts
v1.2.0
- Added metadata to specify environment variable requirements
v1.1.0
- This SKILL includes all required scripts and does not download them from the official repository. Future script updates will be synchronized with this SKILL. If you are using Windows, you must manually download ebktools.ps1 from the ezBookkeeping official repository into the SKILL scripts directory.
v1.0.0
- Initial release of ezBookkeeping skill. - Enables AI agents to add and query transactions, accounts, categories, and tags via the ezBookkeeping API Tools. - Instructions for installing and using the API Tools on Linux, macOS, and Windows included. - Details on required environment variables for configuration.
Metadata
Slug ezbookkeeping
Version 1.3.0
License MIT-0
All-time Installs 10
Active Installs 9
Total Versions 4
Frequently Asked Questions

What is ezBookkeeping API Tools?

Use ezBookkeeping API Tools script to record new transactions, query transactions, retrieve account information, retrieve categories, retrieve tags, and retr... It is an AI Agent Skill for Claude Code / OpenClaw, with 2415 downloads so far.

How do I install ezBookkeeping API Tools?

Run "/install ezbookkeeping" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ezBookkeeping API Tools free?

Yes, ezBookkeeping API Tools is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ezBookkeeping API Tools support?

ezBookkeeping API Tools is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ezBookkeeping API Tools?

It is built and maintained by mayswind (@mayswind); the current version is v1.3.0.

💬 Comments