Summary
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.
Guided setup
Connect Cin7 Core to ChatGPT in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Cin7 Core in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
AnythingMCP's plugin in ChatGPT's directory answers questions from your company databases on AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, read-only): open the listing (opens in a new tab) and click Install plugin. Every other connector is added to ChatGPT as a custom MCP server with your AnythingMCP MCP URL.
Try asking
Example prompts for Cin7 Core
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 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 + ChatGPT
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.
- In Cin7 Core open the API setup page, Integrations → API (inventory.dearsystems.com/ExternalAPI).
- Click + to add an API application and give it a name.
- Copy the Account ID (a GUID) into
CIN7_CORE_ACCOUNT_IDand the Application Key intoCIN7_CORE_APPLICATION_KEY. - Install the connector. Run
cin7_core_get_meto 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 ChatGPT
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 showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
- Enter a name, e.g. Name:
Cin7 Core. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
cin7_core_get_me | Read the Cin7 Core account the keys belong to: company name, base currency, time zone, lock date, tax calculation method, default tax rules |
cin7_core_list_locations | List warehouses and stock locations: ID, Name, address, IsDefault, bins and whether deprecated |
cin7_core_list_products | List products (or read one by id): ID, SKU, Name, Category, Brand, Type (Stock or Service), CostingMethod, UOM, Status, Barcode, price… |
cin7_core_get_product_availability | Stock availability per product and location (and bin or batch): SKU, Name, Location, Bin, Batch, OnHand, Allocated, Available, OnOrder… |
cin7_core_list_sales | List sales (quotes, orders and invoices share one sale record): SaleID, OrderNumber, Status, OrderDate, Customer, CustomerID… |
cin7_core_get_sale | Read one sale with its header (customer, contact, addresses, location, tax rule, terms, price tier, ship-by date, status) and the quote… |
cin7_core_get_sale_order | Read the order part of a sale: SaleOrderNumber, Status (DRAFT, AUTHORISED...), Memo, Lines (ProductID, SKU, Name, Quantity, Price… |
cin7_core_get_sale_fulfilments | Read the fulfilments of a sale: pick, pack and ship stages with their status, lines, boxes, carrier and tracking numbers |
cin7_core_get_sale_invoices | Read the invoices of a sale: TaskID, InvoiceNumber, Status, InvoiceDate, InvoiceDueDate, lines, totals and amounts paid |
cin7_core_get_sale_payments | Read the payments, prepayments and refunds recorded on a sale: Type, Amount, DatePaid, Account, Reference, currency rate |
cin7_core_list_purchases | List purchases: ID, OrderNumber, Status, OrderDate, Supplier, SupplierID, InvoiceNumber, totals, currency, OrderStatus… |
cin7_core_get_purchase | Read one purchase (simple, advanced or service) with supplier, location, approach, tax rule, terms, order, stock received, invoices and… |
cin7_core_get_purchase_order | Read the order part of a purchase: Status, Memo, Lines (ProductID, SKU, SupplierSKU, Name, Quantity, Price, Discount, Tax, TaxRule, Total)… |
cin7_core_list_customers | List customers (or read one by id): ID, Name, Status, Currency, PaymentTerm, TaxRule, PriceTier, Discount, CreditLimit, IsOnCreditHold… |
cin7_core_list_suppliers | List suppliers (or read one by id): ID, Name, Status, Currency, PaymentTerm, AccountPayable, TaxRule, Discount, TaxNumber, addresses and… |
cin7_core_list_tax_rules | List tax rules: ID, Name, Code, TaxPercent, IsTaxForSale, IsTaxForPurchase, IsActive, Account |
cin7_core_list_payment_terms | List payment terms: ID, Name, Duration, Method, IsActive, IsDefault |
cin7_core_list_stock_adjustments | List stock adjustments: TaskID, StocktakeNumber, EffectiveDate, Status (DRAFT, COMPLETED, VOIDED), Reference, Account |
cin7_core_get_stock_adjustment | Read one stock adjustment with its lines (ExistingStockLines, NewStockLines: SKU, location, quantity on hand, adjustment, unit cost, batch)… |
cin7_core_list_stock_transfers | List stock transfers between locations: TaskID, Number, Status (DRAFT, IN TRANSIT, COMPLETED, VOIDED), From and To locations… |
cin7_core_get_stock_transfer | Read one stock transfer with its lines (SKU, TransferQuantity, batch) and status |
cin7_core_create_sale | Create a sale header (customer, location, terms, tax rule, addresses) |
cin7_core_create_sale_order | Add the order lines to a sale created with cin7_core_create_sale |
cin7_core_create_purchase | Create a purchase header for a supplier (advanced purchase endpoint, which serves simple and advanced purchases) |
cin7_core_create_purchase_order | Add the order lines to a purchase created with cin7_core_create_purchase |
cin7_core_create_customer | Create a customer |
cin7_core_update_customer | Update a customer by ID; only the fields given change |
cin7_core_create_supplier | Create a supplier |
cin7_core_create_stock_adjustment | Create a stock adjustment |
cin7_core_create_stock_transfer | Create a stock transfer between two locations |
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.
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?