How do I install the Akaunting skill?

Run npx skillmds@latest add dvcrn/akaunting in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Akaunting safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Akaunting?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Akaunting free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Akaunting?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Akaunting by dvcrn — Agent Skill

Name: Akaunting
Rating: 4.2 (5 reviews)
Author: dvcrn

Akaunting

Interact with Akaunting open-source accounting software via REST API. Use for creating invoices, tracking income/expenses, managing accounts, and bookkeeping automation. Triggers on accounting, bookkeeping, invoicing, expenses, income tracking, or Akaunting mentions.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Akaunting Skill

CLI and API integration for Akaunting, a free open-source accounting platform.

Quick Start

# Test connection
akaunting ping

# List data
akaunting accounts
akaunting categories  
akaunting transactions

# Create transactions
akaunting income --amount 100 --category Sales --description "Payment received"
akaunting expense --amount 50 --category Other --description "Office supplies"

Setup

1. Deploy Akaunting

# Use the provided docker-compose
cp skills/akaunting/assets/docker-compose.yml ~/akaunting/
cd ~/akaunting && docker compose up -d

Access web UI at http://YOUR_IP:8080 and complete the setup wizard.

2. Apply Required Fix

Critical: Akaunting has a bug where module event listeners don't auto-register. Run:

python3 skills/akaunting/scripts/fix_event_listener.py

Or manually add to /var/www/html/app/Providers/Event.php in the $listen array:

'App\Events\Module\PaymentMethodShowing' => [
    'Modules\OfflinePayments\Listeners\ShowAsPaymentMethod',
],

3. Configure Credentials

mkdir -p ~/.config/akaunting
cat > ~/.config/akaunting/config.json << EOF
{
  "url": "http://YOUR_IP:8080",
  "email": "your@email.com",
  "password": "your-password"
}
EOF

Or set environment variables: AKAUNTING_URL, AKAUNTING_EMAIL, AKAUNTING_PASSWORD

CLI Commands

Command	Description
`akaunting ping`	Test API connection
`akaunting accounts`	List bank accounts
`akaunting categories [--type income\|expense]`	List categories
`akaunting transactions [--type income\|expense]`	List transactions
`akaunting items`	List products/services
`akaunting income --amount X --category Y`	Create income
`akaunting expense --amount X --category Y`	Create expense
`akaunting item --name X --price Y`	Create item

Add --json to any command for JSON output.

API Reference

See references/api.md for full endpoint documentation.

Key Endpoints

GET /api/ping - Health check
GET/POST /api/accounts - Bank accounts
GET/POST /api/categories - Income/expense categories
GET/POST /api/transactions - Income/expense records
GET/POST /api/items - Products/services

Authentication: HTTP Basic Auth with user email/password. User needs read-api permission (Admin role has this by default).

Troubleshooting

"Payment method is invalid" error: The event listener fix wasn't applied. Run fix_event_listener.py.

401 Unauthorized: Check credentials in config.json. User must have API access permission.

403 Forbidden on contacts/documents: User needs additional permissions for these endpoints.

---name: akauntingdescription: Interact with Akaunting open-source accounting software via REST API. Use for creating invoices, tracking income/expenses, managing accounts, and bookkeeping automation. Triggers on accounting, bookkeeping, invoicing, expenses, income tracking, or Akaunting mentions.---# Akaunting SkillCLI and API integration for Akaunting, a free open-source accounting platform.## Quick Start```bash# Test connectionakaunting ping# List dataakaunting accountsakaunting categories akaunting transactions# Create transactionsakaunting income --amount 100 --category Sales --description "Payment received"akaunting expense --amount 50 --category Other --description "Office supplies"```## Setup### 1. Deploy Akaunting```bash# Use the provided docker-composecp skills/akaunting/assets/docker-compose.yml ~/akaunting/cd ~/akaunting && docker compose up -d```Access web UI at `http://YOUR_IP:8080` and complete the setup wizard.### 2. Apply Required Fix**Critical:** Akaunting has a bug where module event listeners don't auto-register. Run:```bashpython3 skills/akaunting/scripts/fix_event_listener.py```Or manually add to `/var/www/html/app/Providers/Event.php` in the `$listen` array:```php'App\Events\Module\PaymentMethodShowing' => [ 'Modules\OfflinePayments\Listeners\ShowAsPaymentMethod',],```### 3. Configure Credentials```bashmkdir -p ~/.config/akauntingcat > ~/.config/akaunting/config.json << EOF{ "url": "http://YOUR_IP:8080", "email": "your@email.com", "password": "your-password"}EOF```Or set environment variables: `AKAUNTING_URL`, `AKAUNTING_EMAIL`, `AKAUNTING_PASSWORD`## CLI Commands| Command | Description ||---------|-------------|| `akaunting ping` | Test API connection || `akaunting accounts` | List bank accounts || `akaunting categories [--type income\|expense]` | List categories || `akaunting transactions [--type income\|expense]` | List transactions || `akaunting items` | List products/services || `akaunting income --amount X --category Y` | Create income || `akaunting expense --amount X --category Y` | Create expense || `akaunting item --name X --price Y` | Create item |Add `--json` to any command for JSON output.## API ReferenceSee `references/api.md` for full endpoint documentation.### Key Endpoints- `GET /api/ping` - Health check- `GET/POST /api/accounts` - Bank accounts- `GET/POST /api/categories` - Income/expense categories- `GET/POST /api/transactions` - Income/expense records- `GET/POST /api/items` - Products/servicesAuthentication: HTTP Basic Auth with user email/password. User needs `read-api` permission (Admin role has this by default).## Troubleshooting**"Payment method is invalid" error:**The event listener fix wasn't applied. Run `fix_event_listener.py`.**401 Unauthorized:**Check credentials in config.json. User must have API access permission.**403 Forbidden on contacts/documents:**User needs additional permissions for these endpoints.

Frequently asked questions