# Zoho Inventory — how to use (mcp.ai)

Connect your Zoho Inventory account and use 58 tools for accounting straight from your AI agent. Connect in one click, no API key needed. Zoho Inventory helps businesses track stock, manage orders, and sync inventory across multiple sales channels, streamlining supply chain operations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_zoho_inventory?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `zoho_inventory_add_credit_note_comment`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/zoho_inventory`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/zoho_inventory/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/zoho_inventory/add/credit/note/comment` — Tool to add a comment to a credit note in Zoho Inventory. Use when needing to add notes or comments to a specific credit note for record-keeping or audit purposes.
  - body: { description: string, creditnote_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/add/invoice/attachment` — Tool to upload an attachment to a specific invoice. Use when you need to add a file attachment to an invoice.
  - body: { attachment: object, invoice_id: string, organization_id?: string, can_send_in_mail?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/add/invoice/comment` — Tool to add a comment to a specific invoice in Zoho Inventory. Use when you need to add notes, updates, or internal/client-visible comments to an invoice.
  - body: { invoice_id: string, description: string, organization_id?: string, payment_expected_date?: string, show_comment_to_clients?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/apply/credits/to/invoices` — Tool to apply credits from a credit note to one or more invoices. Use when you need to apply available credits from a credit note to settle invoice balances.
  - body: { invoices: object[], creditnote_id: string, organization_id: string }
- `POST https://api.mcp.ai/api/zoho_inventory/bulk/delete/sales/orders` — Tool to bulk delete sales orders. Use this to remove multiple sales orders at once.
  - body: { salesorder_ids: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/bulk/email/invoices` — Sends multiple invoices by email to a contact in a single API call. Use this tool when you need to email up to 10 invoices at once to a customer. The invoices will be scheduled for delivery and the co
  - body: { contact_id?: string, send_email?: boolean, invoice_ids: string, organization_id?: string, send_snail_mail?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/bulk/export/invoices` — Tool to bulk export invoices as a single PDF. Use when you need to download multiple invoices in a single file for archiving or sharing.
  - body: { invoice_ids: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/bulk/print/invoices` — Generate a consolidated PDF containing multiple invoices for printing or archiving. Use this tool to download one or more invoices as a single PDF document. The PDF can contain up to 25 invoices and i
  - body: { invoice_ids: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/bulk/print/packages` — Tool to bulk print package slips as a consolidated PDF. Use when you need a PDF file of multiple package slips for printing or archiving.
  - body: { package_ids: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/cancel/invoice/write/off` — Tool to cancel write off for an invoice. Use when undoing a previously applied write off on an invoice after verifying the invoice has a write off applied.
  - body: { invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/create/bill` — Tool to create a bill in Zoho Inventory. Use when a vendor supplies goods/services on credit and you need to track the amount owed.
  - body: { date: string, notes?: string, terms?: string, due_date: string, vendor_id: string, line_items: object[], bill_number: string, currency_id?: string, custom_fields?: object[], exchange_rate?: number, organization_id?: string, is_inclusive_tax?: boolean, reference_number?: string, is_item_level_tax_calc?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/create/contact` — Tool to create a new contact (customer or vendor) in Zoho Inventory. Use when you need to add a new business relationship to your organization.
  - body: { notes?: string, website?: string, currency_id?: string, company_name?: string, contact_name: string, contact_type?: string, language_code?: string, payment_terms?: integer, billing_address?: object, contact_persons?: object[], organization_id?: string, shipping_address?: object }
- `POST https://api.mcp.ai/api/zoho_inventory/create/contact/person` — Tool to create a contact person. Use when you need to add a new contact person to an existing contact in Zoho Inventory.
  - body: { email?: string, phone?: string, skype?: string, mobile?: string, last_name?: string, contact_id: string, department?: string, first_name: string, salutation?: string, designation?: string, enable_portal?: boolean, organization_id?: string, communication_preference?: object }
- `POST https://api.mcp.ai/api/zoho_inventory/create/credit/note` — Tool to create a new credit note in Zoho Inventory. Use when you need to issue a credit note to a customer for returns, refunds, or adjustments.
  - body: { date: string, notes?: string, terms?: string, gst_no?: string, tax_id?: string, is_draft?: boolean, cfdi_usage?: string, invoice_id?: string, line_items: object[], customer_id: string, location_id?: string, template_id?: string, custom_fields?: object[], exchange_rate?: string, gst_treatment?: string, tax_treatment?: string, vat_treatment?: string, avatax_tax_code?: string, avatax_use_code?: string, organization_id?: string, place_of_supply?: string, avatax_exempt_no?: string, is_inclusive_tax?: boolean, reference_number?: string, tax_authority_id?: string, tax_exemption_id?: string, creditnote_number?: string, cfdi_reference_type?: string, contact_persons_associated?: object[], ignore_auto_number_generation?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/create/customer/payment` — Tool to create a customer payment in Zoho Inventory. Use when recording a payment received from a customer against one or more invoices.
  - body: { date?: string, amount: number, invoices: object[], account_id?: string, customer_id: string, description?: string, location_id?: string, bank_charges?: number, payment_form?: string, payment_mode: string, custom_fields?: object[], exchange_rate?: number, tax_account_id?: string, organization_id?: string, reference_number?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/create/invoice` — Tool to create a new invoice in Zoho Inventory. Use when you need to invoice a customer for products or services sold.
  - body: { date?: string, notes?: string, terms?: string, gst_no?: string, discount?: number, due_date?: string, adjustment?: number, line_items: object[], project_id?: string, customer_id: string, location_id?: string, template_id?: string, custom_fields?: object[], discount_type?: string, exchange_rate?: number, gst_treatment?: string, payment_terms?: integer, invoice_number?: string, organization_id?: string, payment_options?: object, shipping_charge?: number, is_inclusive_tax?: boolean, reference_number?: string, salesperson_name?: string, payment_terms_label?: string, adjustment_description?: string, allow_partial_payments?: boolean, is_discount_before_tax?: boolean, contact_persons_associated?: string[] }
- `POST https://api.mcp.ai/api/zoho_inventory/create/item` — Tool to create a new item in Zoho Inventory. Use when you need to add a new product or service to your inventory catalog.
  - body: { ean?: string, sku?: string, upc?: string, isbn?: string, name: string, rate?: number, unit?: string, tax_id?: string, item_type?: string, vendor_id?: string, is_taxable?: boolean, description?: string, part_number?: string, vendor_name?: string, product_type?: string, purchase_rate?: number, reorder_level?: number, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/create/item/group` — Tool to create an item group in Zoho Inventory. Use when you need to create a new item group with multiple items that share common attributes like size or color variations.
  - body: { unit: string, brand?: string, items?: object[], tax_id?: integer, attributes?: object[], group_name: string, description?: string, manufacturer?: string, custom_fields?: object[], attribute_name1?: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/create/package` — Tool to create a package for a sales order in Zoho Inventory. Use when you need to prepare items from a sales order for shipping.
  - body: { date: string, notes?: string, line_items: object[], custom_fields?: object[], salesorder_id: integer, package_number: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/create/purchase/order` — Tool to create a purchase order in Zoho Inventory. Use when you need to order goods or services from a vendor.
  - body: { date?: string, notes?: string, terms?: string, vendor_id: string, line_items: object[], delivery_date?: string, organization_id?: string, reference_number?: string, purchaseorder_number?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/create/sales/order` — Tool to create a sales order in Zoho Inventory. Use when a customer places an order for products and you need to track the sale before invoicing.
  - body: { date?: string, notes?: string, terms?: string, gst_no?: string, discount?: number, adjustment?: number, line_items: object[], customer_id: string, estimate_id?: string, template_id?: string, custom_fields?: object[], discount_type?: string, gst_treatment?: string, shipment_date?: string, salesperson_id?: string, billing_address?: object, organization_id?: string, place_of_supply?: string, shipping_charge?: number, is_inclusive_tax?: boolean, reference_number?: string, shipping_address?: object, salesorder_number?: string, adjustment_description?: string, is_discount_before_tax?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/deactivate/contact` — Tool to mark a contact as inactive in Zoho Inventory. Use when you need to deactivate a contact without permanently deleting it.
  - body: { contact_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/deactivate/item` — Tool to mark an item as inactive in Zoho Inventory. Use when you need to deactivate an item without permanently deleting it.
  - body: { item_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/deactivate/item/group` — Tool to mark an item group as inactive in Zoho Inventory. Use when you need to deactivate an item group and all its items without permanently deleting them.
  - body: { itemgroup_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/composite/item` — Permanently deletes a composite item from Zoho Inventory. A composite item (also known as a bundle or kit) is a product made up of multiple individual inventory items sold together as a single unit. T
  - body: { organization_id?: string, composite_item_id: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/contact` — Tool to delete a contact. Use when you need to remove an existing contact from your organization after confirming it is no longer needed.
  - body: { contact_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/contact/person` — Tool to delete a contact person. Use when you need to remove a contact person from your organization after confirming it is no longer needed.
  - body: { organization_id?: string, contact_person_id: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/invoice` — Tool to delete an invoice. Use when you need to remove an existing invoice that has no payments or credits applied.
  - body: { invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/invoice/attachment` — Tool to delete an invoice attachment. Use when you need to remove a file attached to an invoice.
  - body: { invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/invoice/comment` — Delete a specific comment from an invoice in Zoho Inventory. Zoho API: DELETE /inventory/v1/invoices/{invoice_id}/comments/{comment_id} Required query param: organization_id Auth header format: Author
  - body: { comment_id: string, invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/item` — Tool to delete an item. Use when you need to remove an existing inventory item after confirming it is not referenced in any transactions.
  - body: { item_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/item/group` — Tool to delete an item group. Use to remove an existing item group that is no longer needed.
  - body: { itemgroup_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/item/image` — Tool to delete an image associated with an item. Use when you need to remove an item's image after ensuring it's no longer required.
  - body: { item_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/package` — Tool to delete a package. Use when you need to remove an existing package created for a sales order.
  - body: { package_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/delete/sales/order` — Tool to delete a sales order. Use when you need to remove an existing sales order.
  - body: { salesorder_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/disable/payment/reminder` — Tool to disable payment reminders for an invoice. Use when you want to stop automatic payment reminders for an invoice after it has been issued.
  - body: { invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/email/contact` — Tool to email a contact in Zoho Inventory. Use when you need to send an email to a specific contact with a custom subject and body.
  - body: { body: string, subject: string, contact_id: string, to_mail_ids: string[], organization_id?: string, send_customer_statement?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/email/contact/statement` — Tool to email a statement of transactions to a contact. Use when you need to send account statements to customers or vendors.
  - body: { body: string, subject: string, end_date?: string, contact_id: string, start_date?: string, cc_mail_ids?: string[], to_mail_ids: string[], organization_id?: string, send_from_org_email_id?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/email/credit/note` — Tool to email a credit note to customers. Use when you need to send a credit note via email to recipients.
  - body: { body: string, subject: string, attachments?: string, cc_mail_ids?: string[], customer_id?: string, to_mail_ids: string[], creditnote_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/email/invoice` — Tool to email a specific invoice to customers. Use when you need to send an invoice via email, with optional attachments.
  - body: { body?: string, subject?: string, invoice_id: string, attachments?: object[], cc_mail_ids?: string[], to_mail_ids: string[], organization_id?: string, send_attachment?: boolean, send_from_org_email_id?: boolean, send_customer_statement?: boolean }
- `POST https://api.mcp.ai/api/zoho_inventory/enable/invoice/payment/reminder` — Tool to enable payment reminders for an invoice. Use when you want to activate automatic payment reminders for an invoice after it has been issued.
  - body: { invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/get/contact` — Tool to retrieve a specific contact by ID from Zoho Inventory. Use when you need to get detailed information about a customer or vendor contact.
  - body: { contact_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/get/contact/address` — Tool to get contact address. Use when you need to retrieve address information for a specific contact.
  - body: { contact_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/get/credit/note` — Tool to retrieve a credit note by ID. Use when you need to fetch detailed information about a specific credit note.
  - body: { print?: boolean, accept?: string, creditnote_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/get/credit/note/email/content` — Tool to get credit note email content including subject, body, recipients, and available templates. Use when you need to preview or retrieve the email content for a credit note before sending it.
  - body: { creditnote_id: string, organization_id?: string, email_template_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/get/current/user` — Tool to get details of the currently authenticated user in Zoho Inventory. Use when you need to retrieve user profile information, permissions, or validate the authenticated user.
  - body: { organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/get/sales/order` — Tool to retrieve the details of an existing sales order. Use when you need to get complete information about a sales order including line items, customer details, shipping information, and order statu
  - body: { salesorder_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/bills` — Tool to list bills. Use when needing to fetch bills for an organization.
  - body: { page?: integer, per_page?: integer, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/contacts` — Tool to list all contacts (customers and vendors) in Zoho Inventory. Use when needing to fetch contacts for an organization.
  - body: { page?: integer, per_page?: integer, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/credit/notes` — Tool to list all credit notes. Use when needing to fetch credit notes for an organization. Supports filtering by status, customer, date, and other criteria.
  - body: { date?: string, page?: integer, total?: number, status?: string, tax_id?: string, item_id?: string, per_page?: integer, filter_by?: string, item_name?: string, customer_id?: string, search_text?: string, sort_column?: string, line_item_id?: string, customer_name?: string, organization_id?: string, item_description?: string, reference_number?: string, creditnote_number?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/currencies` — Tool to list all currencies configured in Zoho Inventory. Use when you need to retrieve available currencies, exchange rates, or identify the base currency for an organization.
  - body: { page?: integer, per_page?: integer, filter_by?: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/invoice/payments` — Tool to list all payments received for a specific invoice. Use when you need to retrieve payment records for an invoice.
  - body: { invoice_id: string, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/invoices` — Tool to list all invoices in Zoho Inventory. Use when you need to retrieve invoices for an organization.
  - body: { page?: integer, per_page?: integer, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/item/groups` — Tool to list all item groups in Zoho Inventory. Use when needing to fetch item groups for an organization. Item groups allow grouping of related items with variations.
  - body: { page?: integer, per_page?: integer, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/items` — Tool to list all items in Zoho Inventory. Use when you need to retrieve inventory items for an organization.
  - body: { page?: integer, per_page?: integer, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/organizations` — Tool to list all organizations the user has access to in Zoho Inventory. Use when you need to get organization IDs or view available organizations. This action does not require organization_id as a pa
- `POST https://api.mcp.ai/api/zoho_inventory/list/purchase/orders` — Tool to list purchase orders. Use when needing to fetch purchase orders for an organization.
  - body: { page?: integer, per_page?: integer, organization_id?: string }
- `POST https://api.mcp.ai/api/zoho_inventory/list/sales/orders` — Tool to list sales orders. Use when needing to fetch sales orders for an organization.
  - body: { page?: integer, per_page?: integer, organization_id?: string }

## Example prompts
- "What can I do in Zoho Inventory?"
- "Show me a summary of my Zoho Inventory account"

## More
- Page: https://mcp.ai/zoho_inventory
- Agent spec (llms.txt): https://mcp.ai/zoho_inventory/llms.txt
- Postman collection: https://mcp.ai/zoho_inventory/postman.json