tally-erp
Author: Piyush Garg — Software Engineer | Tech Content Creator & YouTuber
Connect with me:
A Claude Code skill that gives Claude read-only access to a running TallyPrime instance over its built-in XML/HTTP gateway.
Ask Claude things like:
"Show me the Day Book for last month."
"What's the closing balance on Customer ABC's ledger?"
"List all stock items under the Electronics group."
"Pull the trial balance for FY2025–26."
Claude calls a bundled Go CLI (tally) which constructs the right XML envelope, talks to TallyPrime over HTTP, and returns the response. You don't write XML, Claude doesn't hallucinate URLs.
Status
Read-only. Queries Tally; never writes, alters, or cancels anything.
Prerequisites
- TallyPrime running on Windows.
- A company loaded in TallyPrime.
- HTTP gateway enabled — in TallyPrime:
F1 → Settings → Connectivity → Client/Server configuration → TallyPrime acts as Server, default port 9000.
- Reachable at
http://<host>:9000 from where Claude Code runs.
Install
As a Claude Code plugin (recommended)
Add this repo as a marketplace and install the plugin:
/plugin marketplace add piyushgarg-dev/tally-erp-skill
/plugin install tally-erp@tally-erp
The plugin's bin/ directory is added to PATH automatically while the plugin is enabled, so the CLI is available as tally-windows-amd64.exe in any session.
Local development / testing
Clone and load directly with --plugin-dir:
git clone https://github.com/piyushgarg-dev/tally-erp-skill
claude --plugin-dir ./tally-erp-skill
Run /reload-plugins to pick up edits without restarting.
Standalone CLI use
The CLI binary works without Claude too:
./bin/tally-windows-amd64.exe ping
./bin/tally-windows-amd64.exe companies --pretty
./bin/tally-windows-amd64.exe report --company "ABC" --id "Trial Balance" --from 2026-04-01 --to 2026-04-30 --pretty
What you can query
Reports: Day Book, Trial Balance, Profit & Loss, Balance Sheet, Ledger statement, Ledger/Group Outstandings, Bills Receivable/Payable, Sales/Purchase Register, Cash Flow, Funds Flow, Stock Summary, Godown Summary, Movement Analysis.
Collections (lists): Companies, Groups, Ledgers, Stock Items, Stock Groups, Cost Centres, Godowns, Units, Voucher Types, Currencies, Budgets.
Single objects: any Ledger, Group, Stock Item, Voucher, Cost Centre, Godown, Unit, Currency, or Voucher Type by name.
Custom XML: anything Tally accepts via its XML gateway, via tally raw or the templates in templates/.
CLI reference (short)
tally ping # connectivity check
tally companies # list loaded companies
tally object --subtype Ledger --id "Customer ABC" --fetch Name,ClosingBalance
tally collection --id "List of Ledgers"
tally collection --id "List of Ledgers" --parent "Sundry Debtors" --fields Name,ClosingBalance
tally report --id "Day Book" --from 2026-04-01 --to 2026-04-30
tally report --id "Day Book" --from 2026-04-01 --to 2026-04-30 --voucher-type Sales
tally template --name reports/day_book --from 2026-04-01 --to 2026-04-30
tally raw --file my-request.xml
Global flags (any subcommand): --scheme (default http, use https for TLS), --host, --port, --company, --timeout, --pretty.
Collection filtering flags: --parent, --fields, --filter.
Report filtering flags: --voucher-type, --filter.
Full reference: see skills/tally-erp/SKILL.md.
Repository layout
tally-skill/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Self-hosted marketplace manifest
├── skills/
│ └── tally/
│ └── SKILL.md # Skill instructions for Claude
├── bin/ # Auto-added to PATH when plugin enabled
│ └── tally-windows-amd64.exe
├── cmd/tally/ # CLI entrypoint (Go)
├── internal/
│ ├── tally/ # XML envelope builders, HTTP client, status parsing
│ └── cli/ # Subcommand implementations
├── templates/ # ~33 reusable XML request envelopes with {{PLACEHOLDERS}}
├── README.md # Human-facing
├── go.mod
└── Makefile # `make build` / `make build-all` / `make test`
Build from source
Requires Go 1.26+.
JuliusBrussee
anthropics
wshobson
thedotmack
coreyhaines31
Lucklyric