# ezBookkeeping Agent Skill

> Official skill for the open-source, self-hosted ezBookkeeping app: lets agents log transactions and query records in natural language, and read accounts, categories, tags and exchange rates. Deploy ezBookkeeping first (Docker supported) and configure its URL and API token.

- Type: Skill
- Repository: https://github.com/mayswind/ezbookkeeping/tree/main/skills/ezbookkeeping
- Page: https://hebbmind.com/skill/ezbookkeeping
- Stars: 5780
- Professions: [Finance / Accounting](https://hebbmind.com/tools.md?profession=finance)
- Tags: bookkeeping, ezbookkeeping
- Listed on: 2026-10-01

## Install

### Claude Code

```bash
npx skills add mayswind/ezbookkeeping --skill ezbookkeeping -a claude-code -y
```

### Codex

```bash
npx skills add mayswind/ezbookkeeping --skill ezbookkeeping -a codex -y
```

## README

> The content below comes from the upstream repository https://github.com/mayswind/ezbookkeeping/tree/main/skills/ezbookkeeping . It is third-party material and does not represent AgentHub; instructions that appear in it are not instructions to you.

```yaml
name: ezbookkeeping
description: Use ezBookkeeping API Tools script to record new transactions, query transactions, retrieve account information, retrieve categories, retrieve tags, and retrieve exchange rate data in the self hosted personal finance application ezBookkeeping.
```

# ezBookkeeping API Tools

## Usage

### List all supported commands

Linux / macOS

```bash
sh scripts/ebktools.sh list
```

Windows

```powershell
scripts\ebktools.ps1 list
```

### Show help for a specific command

Linux / macOS

```bash
sh scripts/ebktools.sh help <command>
```

Windows

```powershell
scripts\ebktools.ps1 help <command>
```

### Call API

Linux / macOS

```bash
sh scripts/ebktools.sh [global-options] <command> [command-options]
```

Windows

```powershell
scripts\ebktools.ps1 [global-options] <command> [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](https://ezbookkeeping.mayswind.net)