<!-- Generated by apps/core/scripts/docs-tools.ts. Do not edit this file. Run the script again. -->

# All tools

Ototo gives your AI assistant 142 QuickBooks tools, plus `qbo_list_companies`.
Your assistant sees all the tools. Ototo checks your access each time the assistant uses a tool.

The **Kind** column shows what the tool does:

- **R**: read. The tool reads data or runs a report.
- **W**: write. The tool creates or changes a record.
- **X**: delete. The tool deletes or voids a record, or makes it inactive.

The **Lowest level** column shows the lowest access level that includes the tool. Higher levels include it too.
For the levels, see [Access levels and permissions](../team/access-levels.md).

> **Note:** Tools that record payments, deposits, transfers and refunds change the records in QuickBooks only.
> They do not send money, charge a card or speak to a bank.

## Tool to list your companies

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_list_companies` | R | Read only | List the QuickBooks companies that you can use through Ototo. |

## Sales & payments (36)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_credit_memo` | R | Read only | Get a credit memo by ID from QuickBooks Online. |
| `qbo_get_deposit` | R | Read only | Get a deposit by ID from QuickBooks Online. |
| `qbo_get_estimate` | R | Read only | Get an estimate by ID from QuickBooks Online. |
| `qbo_get_invoice_pdf` | R | Read only | Get an invoice from QuickBooks Online as a PDF file. |
| `qbo_get_payment` | R | Read only | Get a payment by ID from QuickBooks Online. |
| `qbo_get_refund_receipt` | R | Read only | Get a refund receipt by ID from QuickBooks Online. |
| `qbo_get_sales_receipt` | R | Read only | Get a sales receipt by ID from QuickBooks Online. |
| `qbo_read_invoice` | R | Read only | Read an invoice by ID from QuickBooks Online. |
| `qbo_search_credit_memos` | R | Read only | Search for credit memos in QuickBooks Online. |
| `qbo_search_deposits` | R | Read only | Search for deposits in QuickBooks Online. |
| `qbo_search_estimates` | R | Read only | Search for estimates in QuickBooks Online. |
| `qbo_search_invoices` | R | Read only | Search for invoices in QuickBooks Online. |
| `qbo_search_payments` | R | Read only | Search for payments in QuickBooks Online. |
| `qbo_search_refund_receipts` | R | Read only | Search for refund receipts in QuickBooks Online. |
| `qbo_search_sales_receipts` | R | Read only | Search for sales receipts in QuickBooks Online. |
| `qbo_create_credit_memo` | W | Bookkeeper | Create a credit memo (a credit owed to a customer) in QuickBooks. |
| `qbo_create_deposit` | W | Bookkeeper | Record a bank deposit in QuickBooks. |
| `qbo_create_estimate` | W | Bookkeeper | Create an estimate (quote) for a customer in QuickBooks. |
| `qbo_create_invoice` | W | Bookkeeper | Create an invoice for a customer in QuickBooks. |
| `qbo_create_payment` | W | Bookkeeper | Record a payment received from a customer in QuickBooks. |
| `qbo_create_refund_receipt` | W | Bookkeeper | Record a refund given to a customer in QuickBooks. |
| `qbo_create_sales_receipt` | W | Bookkeeper | Record a sale that the customer paid in full at the time of the sale. |
| `qbo_update_credit_memo` | W | Bookkeeper | Change a credit memo in QuickBooks: customer, private note or document number. |
| `qbo_update_deposit` | W | Bookkeeper | Change the private note on a recorded deposit in QuickBooks. |
| `qbo_update_estimate` | W | Bookkeeper | Change an estimate in QuickBooks. |
| `qbo_update_invoice` | W | Bookkeeper | Change an invoice in QuickBooks. |
| `qbo_update_payment` | W | Bookkeeper | Change a recorded customer payment in QuickBooks: customer, total amount, payment method or private note. |
| `qbo_update_refund_receipt` | W | Bookkeeper | Change a recorded refund receipt in QuickBooks: customer, private note or document number. |
| `qbo_update_sales_receipt` | W | Bookkeeper | Change a recorded sales receipt in QuickBooks: customer, private note or document number. |
| `qbo_delete_credit_memo` | X | Full access | Delete a credit memo from QuickBooks. |
| `qbo_delete_deposit` | X | Full access | Delete a recorded bank deposit from QuickBooks. |
| `qbo_delete_estimate` | X | Full access | Permanently delete an estimate from QuickBooks. |
| `qbo_delete_invoice` | X | Full access | Delete an invoice from QuickBooks. If QuickBooks does not allow the delete, Ototo voids the invoice: the record stays with a zero amount. |
| `qbo_delete_payment` | X | Full access | Delete a recorded customer payment from QuickBooks. |
| `qbo_delete_refund_receipt` | X | Full access | Permanently delete a recorded refund receipt from QuickBooks. |
| `qbo_delete_sales_receipt` | X | Full access | Permanently delete a recorded sales receipt from QuickBooks. |

## Bills, vendors & purchases (30)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_bill` | R | Read only | Get a bill by ID from QuickBooks Online. |
| `qbo_get_bill_payment` | R | Read only | Get a bill payment by ID from QuickBooks Online. |
| `qbo_get_purchase` | R | Read only | Get an expense, check or credit card charge by ID from QuickBooks Online. |
| `qbo_get_purchase_order` | R | Read only | Get a purchase order by ID from QuickBooks Online. |
| `qbo_get_vendor` | R | Read only | Get a vendor by ID from QuickBooks Online. |
| `qbo_get_vendor_credit` | R | Read only | Get a vendor credit by ID from QuickBooks Online. |
| `qbo_search_bill_payments` | R | Read only | Search for bill payments in QuickBooks Online. |
| `qbo_search_bills` | R | Read only | Search for bills in QuickBooks Online. |
| `qbo_search_purchase_orders` | R | Read only | Search for purchase orders in QuickBooks Online. |
| `qbo_search_purchases` | R | Read only | Search for expenses, checks and credit card charges in QuickBooks Online. |
| `qbo_search_vendor_credits` | R | Read only | Search for vendor credits in QuickBooks Online. |
| `qbo_search_vendors` | R | Read only | Search for vendors in QuickBooks Online. |
| `qbo_create_bill` | W | Bookkeeper | Create a bill (a vendor's invoice the company owes) in QuickBooks. |
| `qbo_create_bill_payment` | W | Bookkeeper | Record a payment of one or more vendor bills in QuickBooks. |
| `qbo_create_purchase` | W | Bookkeeper | Record an expense, check or credit card charge in QuickBooks. |
| `qbo_create_purchase_order` | W | Bookkeeper | Create a purchase order to a vendor in QuickBooks. |
| `qbo_create_vendor` | W | Bookkeeper | Create a vendor in QuickBooks. |
| `qbo_create_vendor_credit` | W | Bookkeeper | Create a vendor credit (a credit from a vendor that reduces what the company owes) in QuickBooks. |
| `qbo_update_bill` | W | Bookkeeper | Change a bill in QuickBooks. |
| `qbo_update_bill_payment` | W | Bookkeeper | Change a recorded bill payment in QuickBooks. |
| `qbo_update_purchase` | W | Bookkeeper | Change an expense, check or credit card charge in QuickBooks. |
| `qbo_update_purchase_order` | W | Bookkeeper | Change a purchase order in QuickBooks: vendor, private note or document number. |
| `qbo_update_vendor` | W | Bookkeeper | Change a vendor in QuickBooks. |
| `qbo_update_vendor_credit` | W | Bookkeeper | Change a vendor credit in QuickBooks: vendor, private note, lines or tax calculation. |
| `qbo_delete_bill` | X | Full access | Permanently delete a bill from QuickBooks. |
| `qbo_delete_bill_payment` | X | Full access | Delete a recorded bill payment from QuickBooks. |
| `qbo_delete_purchase` | X | Full access | Permanently delete an expense, check or credit card charge from QuickBooks. |
| `qbo_delete_purchase_order` | X | Full access | Permanently delete a purchase order from QuickBooks. |
| `qbo_delete_vendor` | X | Full access | Delete a vendor in QuickBooks. QuickBooks can refuse this for a vendor that has transactions. |
| `qbo_delete_vendor_credit` | X | Full access | Permanently delete a vendor credit from QuickBooks. |

## Customers (5)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_customer` | R | Read only | Get a customer by ID from QuickBooks Online. |
| `qbo_search_customers` | R | Read only | Search for customers in QuickBooks Online. |
| `qbo_create_customer` | W | Bookkeeper | Create a customer in QuickBooks. |
| `qbo_update_customer` | W | Bookkeeper | Change a customer in QuickBooks. |
| `qbo_delete_customer` | X | Full access | Make a customer inactive in QuickBooks (QuickBooks does not delete customers). |

## Products & services (5)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_read_item` | R | Read only | Read an item by ID from QuickBooks Online. |
| `qbo_search_items` | R | Read only | Search for products and services (items) in QuickBooks Online. |
| `qbo_create_item` | W | Bookkeeper | Create a product or service item in QuickBooks. |
| `qbo_update_item` | W | Bookkeeper | Change a product or service item in QuickBooks. |
| `qbo_delete_item` | X | Full access | Make a product or service item inactive in QuickBooks (QuickBooks does not delete items). |

## Accounting (22)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_account` | R | Read only | Get an account by ID from QuickBooks Online. |
| `qbo_get_class` | R | Read only | Get a class by ID from QuickBooks Online. |
| `qbo_get_department` | R | Read only | Get a department by ID from QuickBooks Online. |
| `qbo_get_journal_entry` | R | Read only | Get a journal entry by ID from QuickBooks Online. |
| `qbo_get_transfer` | R | Read only | Get a transfer by ID from QuickBooks Online. |
| `qbo_search_accounts` | R | Read only | Search for accounts in the chart of accounts in QuickBooks Online. |
| `qbo_search_classes` | R | Read only | Search for classes in QuickBooks Online. |
| `qbo_search_departments` | R | Read only | Search for departments in QuickBooks Online. |
| `qbo_search_journal_entries` | R | Read only | Search for journal entries in QuickBooks Online. |
| `qbo_search_transfers` | R | Read only | Search for transfers in QuickBooks Online. |
| `qbo_create_account` | W | Bookkeeper | Create an account in the chart of accounts in QuickBooks. |
| `qbo_create_class` | W | Bookkeeper | Create a class in QuickBooks. You use classes to put transactions into categories. |
| `qbo_create_department` | W | Bookkeeper | Create a department (location) in QuickBooks. |
| `qbo_create_journal_entry` | W | Bookkeeper | Create a journal entry in QuickBooks. |
| `qbo_create_transfer` | W | Bookkeeper | Record a transfer between two accounts of the company in QuickBooks, for example from checking to savings. |
| `qbo_update_account` | W | Bookkeeper | Change an account in the chart of accounts in QuickBooks, for example its name or description. |
| `qbo_update_class` | W | Bookkeeper | Change the name of a class in QuickBooks, or make it active or inactive. |
| `qbo_update_department` | W | Bookkeeper | Change the name of a department (location) in QuickBooks, or make it active or inactive. |
| `qbo_update_journal_entry` | W | Bookkeeper | Change a journal entry in QuickBooks. |
| `qbo_update_transfer` | W | Bookkeeper | Change a recorded transfer between accounts in QuickBooks: accounts, amount or private note. |
| `qbo_delete_journal_entry` | X | Full access | Permanently delete a journal entry from QuickBooks. |
| `qbo_delete_transfer` | X | Full access | Permanently delete a recorded transfer between accounts from QuickBooks. |

## Reports (12)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_aged_payables` | R | Read only | Get the Aged Payables (A/P Aging) report from QuickBooks Online. It shows unpaid vendor bills. |
| `qbo_get_aged_receivables` | R | Read only | Get the Aged Receivables (A/R Aging) report from QuickBooks Online. It shows unpaid customer invoices. |
| `qbo_get_balance_sheet` | R | Read only | Get the Balance Sheet report from QuickBooks Online. It shows assets, liabilities, and equity. |
| `qbo_get_cash_flow` | R | Read only | Get the Statement of Cash Flows report from QuickBooks Online. |
| `qbo_get_customer_balance` | R | Read only | Get the Customer Balance report from QuickBooks Online. It shows unpaid balances by customer. |
| `qbo_get_customer_sales` | R | Read only | Get the Customer Sales report from QuickBooks Online. It shows sales by customer. |
| `qbo_get_general_ledger` | R | Read only | Get the General Ledger report from QuickBooks Online. It shows detailed transaction history. |
| `qbo_get_profit_and_loss` | R | Read only | Get the Profit and Loss (Income Statement) report from QuickBooks Online. |
| `qbo_get_trial_balance` | R | Read only | Get the Trial Balance report from QuickBooks Online. It shows all account balances. |
| `qbo_get_vendor_balance` | R | Read only | Get the Vendor Balance report from QuickBooks Online. It shows unpaid balances by vendor. |
| `qbo_get_vendor_expenses` | R | Read only | Get the Vendor Expenses report from QuickBooks Online. It shows expenses by vendor. |
| `qbo_search_budgets` | R | Read only | Search for budgets in QuickBooks Online. You can read budgets, but you cannot change them. |

## Taxes (6)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_tax_agency` | R | Read only | Get a tax agency by ID from QuickBooks Online. |
| `qbo_get_tax_code` | R | Read only | Get a tax code by ID from QuickBooks Online. |
| `qbo_get_tax_rate` | R | Read only | Get a tax rate by ID from QuickBooks Online. |
| `qbo_search_tax_agencies` | R | Read only | Search for tax agencies in QuickBooks Online. |
| `qbo_search_tax_codes` | R | Read only | Search for tax codes in QuickBooks Online. |
| `qbo_search_tax_rates` | R | Read only | Search for tax rates in QuickBooks Online. |

## Company & settings (16)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_attachable` | R | Read only | Get an attachment by ID from QuickBooks Online. |
| `qbo_get_company_info` | R | Read only | Get the company information from QuickBooks Online. |
| `qbo_get_payment_method` | R | Read only | Get a payment method by ID from QuickBooks Online. |
| `qbo_get_preferences` | R | Read only | Get the company preferences from QuickBooks Online. These include the accounting method, the use of classes and departments, and purchase order settings. |
| `qbo_get_term` | R | Read only | Get a payment term by ID from QuickBooks Online. |
| `qbo_search_attachables` | R | Read only | Search for attachments in QuickBooks Online. |
| `qbo_search_payment_methods` | R | Read only | Search for payment methods in QuickBooks Online. |
| `qbo_search_terms` | R | Read only | Search for payment terms in QuickBooks Online. |
| `qbo_create_attachable` | W | Bookkeeper | Attach a file or a note to a QuickBooks record, for example a receipt to a bill. |
| `qbo_create_payment_method` | W | Bookkeeper | Create a payment method name in QuickBooks, for example Cash or Check. It does not keep card or bank data. |
| `qbo_create_term` | W | Bookkeeper | Create a payment term in QuickBooks, for example Net 30. |
| `qbo_update_attachable` | W | Bookkeeper | Change the data about an attachment in QuickBooks: file name, note, category or content type. The file does not change. |
| `qbo_update_company_info` | W | Bookkeeper | Change the details of the company in QuickBooks: name, legal name, address, phone, email or website. |
| `qbo_update_payment_method` | W | Bookkeeper | Change the name of a payment method in QuickBooks, or make it active or inactive. |
| `qbo_update_term` | W | Bookkeeper | Change a payment term in QuickBooks: name, due days, discount or active status. |
| `qbo_delete_attachable` | X | Full access | Permanently delete an attachment (file or note) from QuickBooks. |

## Employees & time (10)

| Tool | Kind | Lowest level | What it does |
| --- | --- | --- | --- |
| `qbo_get_employee` | R | Full access | Get an employee by ID from QuickBooks Online. |
| `qbo_get_time_activity` | R | Full access | Get a time entry by ID from QuickBooks Online. |
| `qbo_search_employees` | R | Full access | Search for employees in QuickBooks Online. |
| `qbo_search_time_activities` | R | Full access | Search for time entries in QuickBooks Online. |
| `qbo_create_employee` | W | Full access | Create an employee record in QuickBooks. |
| `qbo_create_time_activity` | W | Full access | Create a time entry in QuickBooks. |
| `qbo_update_employee` | W | Full access | Change an employee record in QuickBooks. |
| `qbo_update_time_activity` | W | Full access | Change a time entry in QuickBooks: hours, minutes, description, billable status or item. |
| `qbo_delete_employee` | X | Full access | Make an employee inactive in QuickBooks (QuickBooks does not delete employees). |
| `qbo_delete_time_activity` | X | Full access | Permanently delete a time entry from QuickBooks. |
