# Odoo eCommerce MCP

> Odoo eCommerce provides a single conversational interface to manage your entire online business. Instantly query product inventory, track customer orders, find leads through CRM records, and review website details—all without leaving your chat window. It connects your core Odoo ERP system directly to your AI agent.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** product-catalog, online-store, customer-orders, inventory-sync, shopping-cart, sales-tracking

## Description

This MCP lets you interact with the full scope of an Odoo ERP instance using natural conversation. Instead of clicking through multiple tabs or jumping between different software applications, your AI client handles the complexity for you. Need to know if a customer made a purchase last month? Ask it. Want to check the stock count and price of a product category? Just ask. You can pull sales data from recent online orders, search specific products by name, and even find contact details for existing customers or new leads. It consolidates everything—from managing the product catalog to tracking active sales pipelines—into one conversation stream. For organizations that rely on Odoo as their central hub, connecting through Vinkius means you get immediate access to this robust set of tools without needing a developer to write custom integrations.

## Tools

### odoo_list_product_categories
Lists the full product category structure used to organize items in your online shop.

### odoo_list_shop_customers
Pulls a list of customers who have made purchases, including their contact details and location data.

### odoo_list_ecommerce_orders
Generates a summary of all online store orders, showing customer, total amount, status, and date placed.

### odoo_list_shop_products
Retrieves a catalog view of all products available on the shop, listing their price, stock quantity, and publishing status.

### odoo_list_websites
Lists every configured Odoo website, providing its domain name and when it was created.

### odoo_search_shop_products
Searches the entire product catalog by name to find specific items, showing their price, stock, and category details.

## 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

### Review product availability and pricing
Check current stock levels, sale prices, and publish status for products across various categories.

### Track recent online sales orders
Retrieve detailed lists of e-commerce transactions, including order number, total amount, customer name, and status.

### Identify and manage buyer contacts
Find specific details like email, phone numbers, and locations for customers who have made purchases.

### Browse the site's structure
List all configured websites or view the full hierarchy of product categories within the shop.

## Use Cases

### Checking stock before a client call
A sales rep needs to confirm if Product XYZ is currently stocked enough to fulfill an emergency order. They don't need to log into the inventory system; they just ask their agent, and it uses odoo_search_shop_products to give them the exact stock quantity and price.

### Auditing recent sales performance
An operations manager needs a quick rundown of all orders placed yesterday. Instead of running reports in three different modules, they ask for 'recent online sales' and use odoo_list_ecommerce_orders to get the full list with status and amounts.

### Updating contact information
An account manager needs the phone number and email for a customer who placed an order last year. They ask their agent, which uses odoo_list_shop_customers to retrieve the exact partner record details right away.

### Understanding site structure
An e-commerce admin needs to know if they have multiple online storefronts running under Odoo. They simply ask about all configured websites, and it uses odoo_list_websites to list the domains for review.

## Benefits

- Cut out the tab-switching. Instead of opening multiple dashboards to check stock, you can use odoo_search_shop_products to find product details instantly in a single chat exchange.
- Get an immediate picture of revenue by running odoo_list_ecommerce_orders. You get status updates and totals without having to navigate the complex order management screens.
- Never lose track of who bought what again. Use odoo_list_shop_customers to pull contact details and purchase history for any client you need to follow up with.
- Understand your full product offering by calling odoo_list_product_categories, which maps out the entire organizational tree of your shop's inventory structure.
- Keep track of all your sales efforts. You can use the CRM tools in the MCP to search for new leads and record opportunities directly through conversation.

## How It Works

The bottom line is that you treat complex database queries like asking a coworker for information over Slack.

1. Connect your preferred AI client through Vinkius and activate this MCP.
2. Ask your agent a question—for example, 'Show me all confirmed sales orders from last week.'
3. The MCP routes the request to Odoo, pulling the exact data needed and presenting it back in a clean, conversational format.

## Frequently Asked Questions

**How does the odoo_list_ecommerce_orders tool work?**
The odoo_list_ecommerce_orders tool summarizes online orders placed through your website. It returns key details like the order number, customer name, total amount, and current fulfillment status.

**Can I check product stock using the odoo_search_shop_products tool?**
Yes, odoo_search_shop_products allows you to search for any item by name. The results include the current stock quantity and whether the product is published on the shop.

**What kind of customer data can I retrieve with odoo_list_shop_customers?**
The tool gathers essential buyer contact information, including name, email address, phone number, city, and country, for customers who have made purchases.

**Does the MCP help me understand my full product catalog? Which tool do I use?**
You can get an overview of your entire inventory structure by using odoo_list_product_categories. This shows all categories and their hierarchy, helping you organize products.

**Can this MCP show me details about my online store setup?**
Yes, the odoo_list_websites tool lists every website configured in your Odoo instance, giving you the name, domain, and creation date for multi-brand setups.