KosmoKrator

accounting

Zoho Books CLI for Shell Scripts

Use the Zoho Books CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.

12 functions 7 read 5 write Manual OAuth token auth
Submit Zoho Books feedback View package source

Zoho Books CLI for Shell Scripts

Call integration functions from shell scripts with stable JSON input and output.

Use shell scripts for small local automations that need one or more integration calls. The Zoho Books CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Zoho Books CLI for Shell Scripts
kosmokrator integrations:configure zoho_books --set access_token="$ZOHO_BOOKS_ACCESS_TOKEN" --set organization_id="$ZOHO_BOOKS_ORGANIZATION_ID" --enable --read allow --write ask --json
kosmo integrations:call zoho_books.zohobooks_list_invoices '{"status":"example_status","customer_id":"example_customer_id","date_start":"example_date_start","date_end":"example_date_end","page":1,"per_page":1,"search_text":"example_search_text"}' --json

Discovery Before Execution

Agents and scripts can inspect Zoho Books docs and schemas before choosing a function.

kosmo integrations:docs zoho_books --json
kosmo integrations:docs zoho_books.zohobooks_list_invoices --json
kosmo integrations:schema zoho_books.zohobooks_list_invoices --json
kosmo integrations:search "Zoho Books" --json
kosmo integrations:list --json

Useful Zoho Books CLI Functions

FunctionTypeParametersDescription
zoho_books.zohobooks_list_invoices Read status, customer_id, date_start, date_end, page, per_page, search_text List invoices from Zoho Books. Returns a paginated list of invoices with optional filters for status, customer, and date range.
zoho_books.zohobooks_get_invoice Read invoice_id Get full details of a specific invoice in Zoho Books by its ID, including line items, totals, payments, and credits.
zoho_books.zohobooks_create_invoice Write customer_id, line_items, date, due_date, invoice_number, reference_number, notes, terms Create a new invoice in Zoho Books. Requires a customer_id and line_items array. Each line item needs at least an item_id or name with a rate and quantity.
zoho_books.zohobooks_update_invoice Write invoice_id, customer_id, line_items, date, due_date, notes, terms, status, reference_number Update an existing invoice in Zoho Books. Provide the invoice_id and any fields to change (line_items, dates, notes, status, etc.).
zoho_books.zohobooks_list_contacts Read contact_type, status, page, per_page, search_text List contacts (customers and vendors) from Zoho Books. Returns a paginated list with optional filters.
zoho_books.zohobooks_get_contact Read contact_id Get full details of a specific contact (customer or vendor) in Zoho Books, including addresses and contact persons.
zoho_books.zohobooks_create_contact Write name, email, phone, company_name, contact_type, billing_address, shipping_address, notes Create a new contact (customer or vendor) in Zoho Books. Requires a name; optionally provide email, phone, company name, and contact type.
zoho_books.zohobooks_list_items Read filter_type, page, per_page, search_text List items (products and services) from Zoho Books. Returns a paginated list with optional filters.
zoho_books.zohobooks_create_item Write name, rate, description, unit, item_type, tax_id, sku Create a new item (product or service) in Zoho Books. Requires a name and rate. Optionally specify item type, description, unit, and tax.
zoho_books.zohobooks_list_estimates Read status, customer_id, date_start, date_end, page, per_page, search_text List estimates (quotes) from Zoho Books. Returns a paginated list with optional filters for status, customer, and date range.
zoho_books.zohobooks_create_estimate Write customer_id, line_items, date, expiry_date, estimate_number, reference_number, notes, terms Create a new estimate (quote) in Zoho Books. Requires a customer_id and line_items array. Each line item needs at least an item_id or name with a rate and quantity.
zoho_books.zohobooks_get_current_user Read none Get information about the currently authenticated Zoho Books user. Useful for verifying connectivity and identifying the active account.

Automation Notes

Related Zoho Books CLI Pages

CI Zoho Books CLI for CI. Cron Jobs Zoho Books CLI for cron jobs. Headless Automation Zoho Books CLI for headless automation. Coding Agents Zoho Books CLI for coding agents.