accounting
Zoho Books CLI for Headless Automation
Use the Zoho Books CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
12 functions 7 read 5 write Manual OAuth token auth
Zoho Books CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. 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 Headless Automation
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
| Function | Type | Parameters | Description |
|---|---|---|---|
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
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.