# Zoho Inventory MCP

> Zoho Inventory MCP connects your AI agent to Zoho's core business data. Manage stock levels, track customer orders, and process invoices all through natural conversation. Need to create new items or check purchase order status? This MCP handles the entire supply chain lifecycle for you.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** stock-tracking, supply-chain, sales-orders, purchase-orders, warehouse-management, inventory-monitoring

## Description

This connector lets you automate complex supply chain tasks without ever opening a dashboard. You can instruct your agent to pull full records of sales orders, list every item in stock, or even find an outstanding invoice balance for a specific vendor. Need to update your product catalog? Just ask the AI to create new items directly within Zoho Inventory.

It handles everything from monitoring global inventory across multiple regions to managing customer and vendor contacts. Because financial data is involved—tracking invoices and purchase orders—the platform running this MCP ensures that every single tool call generates a cryptographically signed, tamper-proof audit trail. This means you always know exactly which piece of data moved and who initiated the change. You connect once from Claude, Cursor, or any compatible client, giving your agent immediate access to critical order and inventory status.

## Tools

### create_item
Creates a brand new inventory item into the system, requiring an item name and sales rate.

### get_item_details
Retrieves all specific information for one identified inventory item.

### list_contacts
Lists both customer and vendor records, essential for finding necessary IDs.

### list_invoices
Pulls a list of all generated inventory invoices to track payments and balances.

### list_items
Provides a basic overview listing all current inventory items in the catalog.

### list_organizations
Lists associated Zoho organizations, which is needed to get the correct ID for other functions.

### list_purchase_orders
Gathers a list of all purchase orders, useful for tracking what you ordered from suppliers.

### list_sales_orders
Provides an overview of every sales order that has been placed against your company.

## Prompt Examples

**Prompt:** 
```
Create a new inventory item called 'Mechanical Keyboard Pro' with a sales rate of 129.99 and fetch the complete item list to verify.
```

**Response:** 
```
I successfully created the 'Mechanical Keyboard Pro' with a rate of $129.99. Your total inventory now contains 156 items. Let me know if you need to update its stock levels.
```

**Prompt:** 
```
List the most recent purchase orders and show me the details of any that are marked as 'Pending Approval'.
```

**Response:** 
```
I retrieved 5 recent purchase orders. There are 2 marked as 'Pending Approval': PO-1024 to 'TechSuppliers Inc' for $4,500 and PO-1025 to 'Global Logistics' for $850. Would you like me to approve them?
```

**Prompt:** 
```
Search the contacts directory for the vendor 'Acme Corp' and fetch their outstanding invoice balance.
```

**Response:** 
```
I found the contact 'Acme Corp' (Contact ID: 839201). They currently have 3 outstanding invoices with a total unpaid balance of $12,450.00.
```

## Capabilities

### Check Stock Levels
Retrieve real-time stock counts and full metadata for every item in the catalog.

### Track Orders
List and monitor both sales orders (what you sold) and purchase orders (what you ordered).

### Manage Contacts
Access customer and vendor databases to find IDs needed for billing or order lookups.

### Audit Billing Records
List all invoices, allowing you to track payment status and outstanding balances.

### Update Catalog Items
Programmatically create new inventory items into the system with a sales rate and description.

## Use Cases

### Investigating a Missing Order
A client needs to know why an order is delayed. They ask the agent to check list_sales_orders first, then cross-reference the customer's ID using list_contacts, and finally pull all relevant invoices with list_invoices.

### Updating Product Lines
The product team launches a new widget. Instead of manually creating it in Zoho, they ask the agent to use create_item, giving the AI the item name and sales rate immediately.

### Quarterly Audit Prep
An analyst needs to reconcile spending. They instruct the agent to list_purchase_orders for Q2 and then get all associated invoices via list_invoices, creating a verifiable audit trail.

### Supplier Management Review
The purchasing manager wants to review vendor relationships. The agent first uses list_contacts to find the vendor ID, and then runs list_purchase_orders to see the full history of bought goods.

## Benefits

- Eliminate dashboard hopping. You can retrieve an item's full details or list all contacts using a single conversation prompt.
- Track the entire order lifecycle. Review both sales orders (list_sales_orders) and purchase orders (list_purchase_orders) to maintain end-to-end visibility.
- Keep your catalog current. Use create_item to add new products with minimal manual effort, updating your inventory list instantly.
- Know who owes money. Call list_invoices to pull a summary of billing status or check vendor balances using list_contacts.
- Global coverage is built-in. The MCP supports multiple regions (US, EU, IN, AU, CA), automating logistics across international data centers.

## How It Works

The bottom line is you tell your agent what business data you need; it handles the connection and pulls the specific records for you.

1. Subscribe to this MCP and provide your Zoho Inventory Access Token and Organization ID.
2. Select your preferred hosting region (e.g., 'US' or 'EU') in the Vinkius platform.
3. From your AI client, ask your agent to perform a task, like listing purchase orders or checking item details.

## Frequently Asked Questions

**How do I use list_contacts with Zoho Inventory?**
You run list_contacts first to pull a full directory of all your customers and vendors, obtaining their unique IDs. This is often necessary before you can search for outstanding balances using list_invoices.

**Can I create new items with the create_item tool?**
Yes, the create_item tool lets you programmatically add a new item to your catalog. You must provide both the item's name and its sales rate for the creation to succeed.

**What is the difference between list_items and get_item_details?**
list_items gives you a high-level overview of every product ID and basic metadata. You use get_item_details when you need deep, specific information on one particular item, like its full history or multiple attributes.

**Is list_purchase_orders the same as list_sales_orders?**
No, they track opposite flows. list_sales_orders tracks what your company sold to customers. list_purchase_orders tracks what your company bought from suppliers.

**What is the purpose of running `list_organizations` first?**
It provides the critical Organization ID needed to run most other inventory tools. You must successfully retrieve this organization context before your agent can interact with specific accounts, like listing invoices or viewing purchase orders.

**Can I use `list_invoices` to find out which customers have unpaid bills?**
Yes, running `list_invoices` provides a full view of the billing history. The results let your agent filter by payment status, so you can quickly identify outstanding balances for collections or accounting review.

**If I use `list_contacts`, how do I ensure I get the correct ID needed for an order?**
The output from `list_contacts` gives you unique Contact IDs. When your agent needs to process orders or invoices, it must reference these specific IDs to pinpoint the exact customer record without confusion.

**Does running `list_purchase_orders` allow for automated follow-up actions?**
It provides the necessary purchase order details and supplier information. You can then chain this data with other MCPs to trigger manual approvals or send status updates via messaging tools.

**How do I find my Zoho Organization ID?**
Your Organization ID is visible in the top right corner of your Zoho Inventory dashboard or under 'Settings' > 'Organization Profile'.

**Which Zoho regions are supported by this integration?**
We support all major Zoho data centers: US, EU, IN, AU, and CA. Ensure you select the region where your account was created.