Connect Cin7 Core to Gemini CLI via MCP

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

Cin7 Core + Gemini

Cin7 Core (formerly DEAR Inventory) through External API v2: products and stock availability per location, sales with orders, fulfilments, invoices and payments (read only), purchases, customers, suppliers, stock adjustments and transfers. Create sales, purchases, customers, suppliers and transfers. Account ID and Application 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_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_KEY

Step 1 — Get credentials

Setting up takes about 2 minutes. You need a Cin7 Core account (formerly DEAR Inventory; you sign in at inventory.dearsystems.com) with access to Integrations → API. The connector needs the Account ID and an Application Key.

Core or Omni? Cin7 sells two different products. Cin7 Core (this connector, formerly DEAR Systems) uses an Account ID and an Application Key. Cin7 Omni (the original Cin7, go.cin7.com) has a separate API v1 with an API username and key: use the Cin7 Omni connector for it. The credentials of one do not work on the other.

1. In Cin7 Core open the API setup page, Integrations → API (inventory.dearsystems.com/ExternalAPI).
2. Click + to add an API application and give it a name.
3. Copy the Account ID (a GUID) into CIN7_CORE_ACCOUNT_ID and the Application Key into CIN7_CORE_APPLICATION_KEY.
4. Install the connector. Run cin7_core_get_me to check the connection: it returns the company name, base currency and time zone of the account.

Cloud and self-hosted work the same way: the credentials are the same, and there is no redirect URL to set. The connector sends them in the api-auth-accountid and api-auth-applicationkey headers. Deleting the API application in Cin7 Core revokes the key.

Where to start: cin7_core_get_me for the base currency, cin7_core_list_locations for location names, then cin7_core_list_sales and cin7_core_get_product_availability, which answer most questions.

What it reads: products with price tiers, stock availability per product and location (on hand, allocated, available, on order); sales with their quote, order, fulfilments (pick, pack and ship, with carrier and tracking), invoices and payments; purchases with their order; customers, suppliers, tax rules and payment terms; stock adjustments and stock transfers.

Creating a sale takes two calls: cin7_core_create_sale makes the header (customer, location) and returns its ID, then cin7_core_create_sale_order adds the lines. Lines need Name, Quantity, Price, Tax and TaxRule plus SKU or ProductID. The AI keeps the order DRAFT unless you want it authorised: AUTHORISED allocates stock, backorders a shortfall without warning and locks the order against further API edits. Purchases work the same way, with cin7_core_create_purchase and cin7_core_create_purchase_order.

Other writes: cin7_core_create_customer, cin7_core_update_customer and cin7_core_create_supplier (they need payment term and tax rule names and account codes, which cin7_core_list_payment_terms and cin7_core_list_tax_rules list), and cin7_core_create_stock_transfer (DRAFT by default). All of these are switched on.

Switched off at install: cin7_core_create_stock_adjustment (create a stock adjustment). A COMPLETED adjustment posts stock movements and accounting entries at once, and its quantities are the new on-hand values, not differences. Switch it on on the connector page if the AI should use it; the AI asks you to confirm every change.

No money and no deletes: the connector never records, changes or deletes payments, invoices or credit notes, and it has no delete or void tools.

Identifiers: records use GUIDs (ID, SaleID, TaskID). Locations, tax rules, payment terms and price tiers are referenced by name.

Paging: lists take page (from 1) and limit (default 100, at most 1,000); the answer carries Total. updated_since or modified_since return only what changed. Dates are UTC, yyyy-MM-ddTHH:mm:ss.

Rate limit: 60 calls a minute per API application; beyond that Cin7 Core answers 429 (older accounts 503). Large pages and filters use the budget better than many small calls.

Common errors: a refused call answers 400 with [{"ErrorCode": 400, "Exception": "..."}] naming the problem, such as an unknown customer, location or tax rule, or a document that is already authorised. 403 means a wrong Account ID or Application Key.

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 Core tools.

Available tools

Example prompts

• "How many units of SKU MUG-WHT-350 are available in each location?"
• "List this month's sales that are authorised but not fully fulfilled yet."
• "Show the fulfilment of order SO-1042 with its carrier and tracking number."
• "Which purchases are still waiting for stock to be received?"
• "Create a draft sale for customer Coffee Corner at the Main Warehouse with 24 units of MUG-WHT-350 at 6.50."

FAQ

I use Cin7 Omni (go.cin7.com). Is this the right connector? No. Cin7 Omni has a separate API v1 with an API username and key: use the Cin7 Omni 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