← Back to Skills Marketplace
Cin7 Inventory
by
Yashthesiya1
· GitHub ↗
· v2.0.0
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 IDCIN7_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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cin7-inventory - After installation, invoke the skill by name or use
/cin7-inventory - 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
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.
More Skills