# Odoo Inventory MCP

> Odoo Inventory MCP lets you manage every aspect of your warehouse operation without logging into multiple screens. Track stock levels across all physical bins, audit complex product movements, and trace specific lots or batches using natural conversation with any AI client.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** stock-levels, warehouse-management, lot-tracking, stock-transfers, procurement, logistics

## Description

Managing inventory means constant data hopping—jumping from the main dashboard to location reports, then over to transfer logs, just to answer one simple question about availability. This MCP connects your entire Odoo ERP system directly to your agent, letting you manage stock and warehouse logistics purely through conversation.

You don't need to learn new report filters or navigate complex menus. You ask for the status of a specific product by location, or you request an audit trail of every move that happened last week. The AI handles the data querying across records, allowing your agent to give you immediate answers about stock levels, pending adjustments, and where everything is physically stored. It’s like having all your warehouse knowledge instantly available in one place. When you connect this MCP through Vinkius, your agent gets access to Odoo's complete inventory control structure—from the highest-level warehouses down to individual storage bins.

## Tools

### odoo_product_stock
Retrieves detailed stock quantities for a product, showing exactly how much is in each internal storage location.

### odoo_get_transfer
Provides the complete details of a single stock transfer, including all individual move lines that make up the shipment.

### odoo_list_adjustments
Lists pending inventory adjustments—any proposed stock correction waiting for management review or approval.

### odoo_list_locations
Returns a list of every internal storage bin and zone within your warehouses, detailing the physical structure.

### odoo_list_stock_moves
Generates an audit trail by listing individual product movements, showing what moved from where and when.

### odoo_list_transfers
Lists all stock batches (receipts, deliveries, internal moves) along with their current processing status in Odoo.

### odoo_list_warehouses
Provides an overview of every configured warehouse in the system, including its short code and address.

### odoo_search_lots
Searches for specific product batches or serial numbers to trace them back to their original source.

### odoo_search_inventory_products
Checks the general stock status of products, returning real-time quantities available and amounts scheduled to arrive or ship out.

## Prompt Examples

**Prompt:** 
```
Search for leads from the website
```

**Response:** 
```
👥 **CRM Leads — Website**
| Name | Email | Stage | Revenue |
|---|---|---|---|
| Acme Corp | info@acme.com | Qualification | $15,000 |
| Beta Inc | hello@beta.io | Proposition | $8,500 |
```

**Prompt:** 
```
Show recent sales orders
```

**Response:** 
```
📋 **Sales Orders**
| SO# | Customer | Amount | Status |
|---|---|---|---|
| S00042 | Acme Corp | $12,500 | Confirmed |
| S00041 | Beta Inc | $3,200 | Draft |
```

## Capabilities

### Audit stock by precise location
You can find out exactly how much of a product exists in Warehouse A versus Warehouse B, looking at every internal zone.

### Trace inventory batches and lots
The system searches for specific lot numbers or serial identifiers to track a product's full history and origin.

### Review all stock movements
You get a granular, chronological list of every product movement—from where it left and where it arrived.

### Check current inventory status
The MCP provides real-time counts for products, showing what's available now versus what's incoming or scheduled to go out.

### Manage transfers and adjustments
You can list all pending stock corrections or review the full details of a specific receiving or shipping transfer.

## Use Cases

### Investigating a shortage
A warehouse employee notices an unaccounted-for product. They ask their agent to run the odoo_list_stock_moves for that item over the last 48 hours, quickly identifying which transfer batch (using odoo_list_transfers) was involved and where it went wrong.

### Verifying quality control
A manager needs to confirm if a specific shipment contained products from the same contaminated lot. They use odoo_search_lots to search by batch number, then verify that all items on a pending order match that traceable source.

### Planning warehouse space
An operations analyst needs to map out their physical storage network. They ask the agent for odoo_list_locations and odoo_list_warehouses to get a complete structure report, helping them plan optimal placement.

### Receiving goods from a supplier
When receiving a large shipment, they use odoo_list_adjustments first to see if any expected corrections are pending. Then, the agent reviews the specific delivery details by calling odoo_get_transfer to ensure every item was recorded correctly.

## Benefits

- Stop guessing stock levels. Use odoo_search_inventory_products to check real-time availability, factoring in incoming and outgoing quantities.
- Pinpoint exactly where inventory is stored using odoo_product_stock; you get quantity broken down by every internal location, not just a total number.
- Track products with confidence. Call odoo_search_lots anytime you need to trace an item back through its specific batch or lot number for compliance.
- Understand the full journey of goods. Running odoo_list_stock_moves gives you a detailed audit log, showing every product movement from start to finish.
- Manage logistics flow without jumping between tabs. The MCP lets you review large groups of moves using odoo_list_transfers and drill down into specifics with odoo_get_transfer.

## How It Works

The bottom line is your AI client speaks to the ERP system directly, giving you data answers instead of dashboards.

1. Connect your AI client to this MCP via Vinkius, granting it access to read and query Odoo's inventory data.
2. Ask your agent a natural language question, like 'How much Product X is in Warehouse 3?' or 'What transfers are pending approval?'.
3. Your agent executes the necessary queries across multiple underlying tools and presents you with a compiled, specific answer.

## Frequently Asked Questions

**How does odoo_product_stock work?**
The odoo_product_stock tool gives you detailed product quantities broken down by every specific internal warehouse location, not just a total count. This is critical for knowing where to physically find an item.

**Can I check if a batch number exists using odoo_search_lots?**
Yes, odoo_search_lots searches Odoo by lot name or number. It returns the associated product and the total quantity currently linked to that specific batch for full traceability.

**What is the difference between odoo_list_transfers and odoo_get_transfer?**
odoo_list_transfers gives you a summary list of all transfers (like incoming or outgoing batches). You use odoo_get_transfer to drill down into one specific transfer record for every detailed move line within it.

**Does this MCP help with auditing?**
Absolutely. The MCP provides tools like odoo_list_stock_moves, which create a full audit trail of all products that have moved, along with the ability to list pending adjustments via odoo_list_adjustments.

**Can I find my warehouse codes?**
Yes. You can use odoo_list_warehouses and odoo_list_locations to get an overview of all top-level warehouses and the specific internal storage bins within them.