← Back to Skills Marketplace
yashthesiya1

Cin7 Inventory

by Yashthesiya1 · GitHub ↗ · v2.0.0
cross-platform ✓ Security Clean
489
Downloads
2
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install cin7-inventory
Description
Cin7 Core inventory management -- products, stock, orders, purchases, customers, and suppliers via bash scripts.
README (SKILL.md)

Cin7 Inventory Management

Manage Cin7 Core inventory via bash scripts. All commands run from the skill directory.

Required Environment Variables

  • CIN7_ACCOUNT_ID — your Cin7 Core account ID
  • CIN7_APP_KEY — your Cin7 Core application key

Products

List/search products

bash scripts/get-products.sh
bash scripts/get-products.sh --search "widget" --page 2

Get single product

bash scripts/get-product.sh --id "product-id"

Stock

Check stock levels

bash scripts/get-stock.sh
bash scripts/get-stock.sh --product-id "product-id"
bash scripts/get-stock.sh --page 2

Adjust stock (damage, recount, write-off)

bash scripts/stock-adjustment.sh --data '{"Lines":[{"ProductID":"id","Location":"Main Warehouse","Quantity":5}]}'

Transfer stock between locations

bash scripts/stock-transfer.sh --data '{"Lines":[{"ProductID":"id","From":"Warehouse A","To":"Warehouse B","Quantity":10}]}'

Sales Orders

List orders

bash scripts/list-orders.sh
bash scripts/list-orders.sh --status "COMPLETED" --page 1

Get single order

bash scripts/get-order.sh --id "order-id"

Create order

bash scripts/create-order.sh --data '{"Customer":"John Smith","Lines":[{"ProductID":"id","Quantity":2}]}'

Update order

bash scripts/update-order.sh --id "order-id" --data '{"Status":"COMPLETED"}'

Sales report by date range

bash scripts/sales-report.sh --from "2026-01-01" --to "2026-03-07"

Purchase Orders

List purchase orders

bash scripts/get-purchases.sh
bash scripts/get-purchases.sh --status "ORDERED" --page 1

Create purchase order

bash scripts/create-purchase.sh --data '{"Supplier":"Acme Corp","Lines":[{"ProductID":"id","Quantity":100}]}'

Customers & Suppliers

List/search customers

bash scripts/get-customers.sh
bash scripts/get-customers.sh --search "John"

List/search suppliers

bash scripts/get-suppliers.sh
bash scripts/get-suppliers.sh --search "Acme"
Usage Guidance
This skill appears coherent for managing Cin7 Core via bash scripts. Before installing or running: (1) only provide the Cin7 account ID and app key — avoid putting unrelated secrets into the skill's .env because the scripts export every .env key; (2) review and, if desired, run the scripts in an isolated account or container to validate behavior; (3) confirm the API base URL matches your Cin7 instance and official docs; (4) inspect the update-order JSON construction (it injects the ID via sed) if you plan to pass complex JSON to ensure it produces valid payloads; and (5) verify you trust the skill source (homepage/owner metadata) since code runs locally.
Capability Analysis
Type: OpenClaw Skill Name: cin7-inventory Version: 2.0.0 The skill is a legitimate set of bash scripts designed to interface with the Cin7 Core API for inventory management tasks such as product searching, order creation, and stock adjustments. It uses standard curl commands with API keys provided via environment variables or a local .env file, and all network requests are directed to the official Cin7 API endpoint (inventory.dearsystems.com).
Capability Assessment
Purpose & Capability
Name/description, required binaries (curl, bash), required env vars (CIN7_ACCOUNT_ID, CIN7_APP_KEY), and all script functionality consistently target the Cin7 Core API. The API headers, endpoints, and operations implemented (products, stock, orders, purchases, customers, suppliers) align with the declared purpose.
Instruction Scope
SKILL.md instructs running the included bash scripts from the skill directory; the scripts do only HTTP calls to the Cin7 API and parse command-line args. One notable behavior: scripts source a .env file (if present) and config.sh exports every key/value found, which is broader than strictly necessary if the .env contains unrelated secrets. Otherwise the instruction scope is narrow and consistent with the stated task.
Install Mechanism
This is instruction-only / script-based with no install spec and no network downloads or package installs. All code is provided in the bundle and executed with bash/curl, which is low-risk compared to remote install steps.
Credentials
The skill requires only two Cin7-related environment variables (CIN7_ACCOUNT_ID, CIN7_APP_KEY), which is proportionate. Caveat: config.sh will load and export all variables from a .env file in the skill directory (and falls back to CIN7_API_KEY), so placing other secrets in that .env could expose them to the scripts' runtime environment.
Persistence & Privilege
The skill does not request persistent/always-on privileges and does not modify other skills or system-wide agent settings. It appears to run only when invoked.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cin7-inventory
  3. After installation, invoke the skill by name or use /cin7-inventory
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
Major update: Fully transitions from Python server to an expanded bash script–only toolkit, with new purchase, stock, and contact features. - Removed MCP Python server and all Python dependencies; now 100% bash scripts using curl. - Added scripts for managing purchases, suppliers, customers, stock adjustments, and stock transfers. - Enhanced order and product scripts; improved examples and documentation. - Centralized environment setup and requirements for easier installation. - Updated and streamlined documentation in SKILL.md and README.md.
v1.1.0
Major update: Adds bash script support alongside MCP server. - Introduced bash scripts for all key inventory, order, and report tasks; scripts require only curl and bash (no Python). - README/skill doc expanded with detailed setup and usage for both MCP server and scripts. - Updated repository homepage URL. - No API/tool changes; existing MCP server tools unchanged. - Environment variable setup instructions added for both approaches.
v1.0.0
Initial release of Cin7 Inventory skill. - Query, list, and search products in Cin7 inventory. - View detailed product information and check stock levels by product ID. - List stock levels across all warehouses. - Manage sales orders: list, view, create, and update orders. - Retrieve sales summary reports for specified date ranges.
Metadata
Slug cin7-inventory
Version 2.0.0
License
All-time Installs 1
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is Cin7 Inventory?

Cin7 Core inventory management -- products, stock, orders, purchases, customers, and suppliers via bash scripts. It is an AI Agent Skill for Claude Code / OpenClaw, with 489 downloads so far.

How do I install Cin7 Inventory?

Run "/install cin7-inventory" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cin7 Inventory free?

Yes, Cin7 Inventory is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Cin7 Inventory support?

Cin7 Inventory is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cin7 Inventory?

It is built and maintained by Yashthesiya1 (@yashthesiya1); the current version is v2.0.0.

💬 Comments