1C-Fresh CLI and MCP server
1C-Fresh: CLI и MCP
A Go CLI and local MCP server for 1C-Fresh over OData: products, prices, stock, customers, orders, sales and money
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- create_product, create_customer and update_product write data into a live 1C-Fresh base
- Writing to a live base is flagged by the author as not fully verified
Install
Manual install
go build -o bin/1c ./cmd/1cfreshBuilds the CLI and MCP server from source on Go 1.25+.
This is third-party code. Review the repository files before installing.
What it does
The tool provides a single Go client to 1C-Fresh OData and exposes it two ways: 1c ACTION RESOURCE CLI commands and an MCP server over stdio. It covers reading and partial writing of product groups, products, customers and suppliers, prices and price-setting documents, warehouse stock, customer orders, sales and purchase documents, warehouse documents, cash and bank money records, and cash receipts. A dedicated audit receipts command checks unposted receipts for a date range. Writing is currently limited to product groups, counterparty folders, Stock and Service type products, customers and suppliers; posting documents, deletion and arbitrary OData queries are not implemented.
Who it is for. For small business owners and developers who run their books in 1C-Fresh and want reports and reference-data edits through an agent.
Good fit when
- You want to check stock, prices or unposted receipts for a period from a chat with an agent
- You want to create or rename a product, customer or supplier without opening the 1C-Fresh app itself
- You need a CLI for scripting around 1C-Fresh
Not a fit when
- You need to post or delete documents: those tools do not exist yet
- You need standard desktop 1C, not the cloud 1C-Fresh service
Example request
Show unposted sale receipts for the last week and the stock of PRODUCT_GUID at the warehouseLimitations
The README itself says write behavior against a live base is not fully verified: for example, fetching an invoice by GUID on a live record was not tested, and the invoice resource was empty in the tested base. There is no object deletion or a general OData editor. Some reads scan resource history and can take a few seconds.
How to disable. Remove the 1c binary symlink from PATH and drop it from your MCP client configuration.
MCP
- Transport
- stdio
- Authentication
- not required
| Environment variables | |
|---|---|
| ONEC_ODATA_BASE_URL required | Link to the 1C-Fresh app, without /odata/ at the end. |
| ONEC_ODATA_USERNAME required | User with OData access. |
| ONEC_ODATA_PASSWORD required, secret | Password of the OData user. |
Security check
- create_product, create_customer and update_product write data into a live 1C-Fresh base
- Writing to a live base is flagged by the author as not fully verified
README in short
The Russian-language README lists dozens of CLI commands for products, prices, stock, customers, suppliers, orders, sales, purchases, warehouse documents, money and receipts, explains login via 1c login that saves a user-only .env, and gives a table of read and write MCP tools. It notes that writing to a live base is not fully verified, and deletion or arbitrary OData queries are absent.
FAQ
Can the tool post a document?
No, there is no document posting, deletion, or a general OData editor.
What does audit receipts do?
It checks sale and return receipts over a date range for Posted=false, up to 31 days and 1000 receipts per call.
Related
A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language
inn-check-ru: counterparty risk traffic light
inn-check-ru
An open-source skill that checks a Russian company by tax ID across EGRUL, bailiffs, courts, bankruptcy and sanctions, and returns a dated risk verdict