Connect Cin7 Omni to Gemini CLI via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Cin7 Omni, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Cin7 Omni + Gemini

Cin7 Omni (go.cin7.com) inventory and order management through API v1: sales orders, quotes, purchase orders, credit notes, contacts, products, stock per branch, branches, payments (read only), stock adjustments, branch transfers and users. Create orders, purchase orders, contacts and transfers. API username and key.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

CIN7_OMNI_API_USERNAME, CIN7_OMNI_API_KEY

Step 1 — Get credentials

Setting up takes about 3 minutes. You need a Cin7 Omni account (you sign in at go.cin7.com) and an administrator who can add an API v1 connection. The connector needs the API username and an API key.

Omni or Core? Cin7 sells two different products. Cin7 Omni (this connector) signs in at go.cin7.com and has API v1 with an API username and key. Cin7 Core (formerly DEAR Inventory) signs in at inventory.dearsystems.com and has its own API with an Account ID and Application Key: use the Cin7 Core connector for it. The two APIs and their credentials are not interchangeable.

1. In Cin7 Omni open the user menu, then Settings → Integrations & API → API v1.
2. Copy the API Username shown at the top of the page into CIN7_OMNI_API_USERNAME.
3. Click Add New API Connection, give it a name and copy its API key into CIN7_OMNI_API_KEY. Regenerate Key replaces a lost key.
4. Under Permissions tick Read for every resource the AI should see, and Create or Update for the resources the write tools need, then click Save. A resource without permission answers 403.
5. Install the connector. Run cin7_omni_list_branches to check the connection: it lists your branches with their ids.

Cloud and self-hosted work the same way: the credentials are the same, and there is no redirect URL to set. The connector sends the username and key as HTTP Basic authentication.

Where to start: cin7_omni_list_branches for branch ids, cin7_omni_list_sales_orders for recent orders, cin7_omni_list_stock for stock per branch, and cin7_omni_list_contacts to find a customer or supplier.

What it reads: sales orders, quotes and credit notes with their line items; payments recorded against orders; purchase orders; products, their options (the sellable SKUs) with prices and categories; stock per product option and branch (available, on hand, open sales, incoming); stock adjustments and branch transfers; contacts and users.

What it writes: cin7_omni_create_sales_order, cin7_omni_update_sales_order (header fields only, such as stage, tracking code and delivery instructions), cin7_omni_create_purchase_order, cin7_omni_create_contact, cin7_omni_update_contact and cin7_omni_create_branch_transfer are switched on. A new sales order is approved unless the AI creates it as a draft; purchase orders and transfers are saved as drafts unless approved. Dispatch and receipt of transfers happen in Cin7.

Switched off at install: cin7_omni_create_adjustment (create a stock adjustment in one branch). An approved adjustment changes stock on hand and stock value at once. Switch it on on the connector page if the AI should use it; the AI asks you to confirm every change.

Check the answer of every write: Cin7 answers HTTP 200 with a list of {index, success, id, code, errors}, also when it refused the record. The AI checks success and errors before it reports a write as done.

Payments are read only: the connector never records, changes or deletes a payment, and it does not dispatch, invoice or void orders.

Filtering: where takes SQL-style conditions on fields of the record, not of its line items. Strings and dates go in single quotes, numbers stay bare: modifiedDate>='2026-01-01T00:00:00Z' AND branchId=3, reference LIKE 'SO-10%', id IN (21,24). Dates are UTC, yyyy-MM-ddTHH:mm:ssZ. fields trims the answer (id,reference,total,lineItems(code,qty)), which helps with order lists, because they are large.

Paging: page starts at 1 and rows is at most 250 (default 50, 25 on order lists). The AI asks for the next page until one comes back empty.

Rate limits: Cin7 Omni allows 3 calls a second, 60 a minute and 5,000 a day per account; beyond that it answers 429 with Retry-After. Large rows with narrow where filters use the budget better than many small calls.

Values: order status is DRAFT, APPROVED or VOID, and stage is a free-text workflow stage (New, Awaiting Payment, Processing, On Hold, Dispatched). Stock available is stock on hand minus open sales. Contact type is Customer, Supplier or Internal. Writes take amounts in the order currency; reads return base currency values with the exchange rate. New users can take up to 2 hours to appear in cin7_omni_list_users.

Common errors: 403 means the API connection has no permission for that resource: tick it under Permissions and save. 429 is the rate limit: wait for the Retry-After time.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
4. Start prompting — Gemini CLI can now call the Cin7 Omni tools.

Available tools

Example prompts

• "Which sales orders were approved this week and are not dispatched yet?"
• "How much stock of SKU TSHIRT-BLK-M is available in each branch?"
• "Which purchase orders are due to arrive this month, and from which suppliers?"
• "Find the customer with the email [email protected] and show their balance owing."
• "Create a draft transfer of 20 units of TSHIRT-BLK-M from the main warehouse to the city store."

FAQ

I use Cin7 Core (DEAR Inventory). Is this the right connector? No. Cin7 Core has its own API and credentials: use the Cin7 Core connector. Credentials of one product do not work on the other.

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude