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
- 2 ★ on the repository
- Last commit
Broad access
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
- Works in
- Services
Manual install
go build -o bin/1c ./cmd/1cfreshBuilds the CLI and MCP server from source on Go 1.25+.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- 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
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 warehouseMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
ONEC_ODATA_BASE_URLrequired- Link to the 1C-Fresh app, without /odata/ at the end.
ONEC_ODATA_USERNAMErequired- User with OData access.
ONEC_ODATA_PASSWORDrequired, secret- Password of the OData user.
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise toolsAn MCP server for 1C-Fresh over standard OData: invoices, sales, counterparties, working around known 1C-Fresh OData quirks and the 22 percent VAT
MCP server for 1C:Enterprise data over OData: receivables, sales, stock and cash, plus document creation and posting behind a separate flag
A Go MCP gateway between an agent and a 1C HTTP service: references, sales, stock, cash and settlement reporting across several databases
MCP server for 1C:Enterprise databases over standard OData: catalogs, documents, registers and accounting with no configuration extension
AI Finansist: MCP server for 1C
mcp_1c (AI Финансист)
An MCP server, a 1C OData client and a local language model bundled with a Gradio chat for questions about 1C data and uploaded PDFs
1C OData MCP with a JSON cache
MCP сервер для работы с OData 1C
A Python MCP server over 1C OData: reads and changes catalogs and documents, saving everything to JSON files for local analysis without repeat queries
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| 1C-Fresh CLI and MCP server (this card) | no | not required | 2 | |
| SourceCraft MCP and CLI: repos and CI/CD | no | API key | 0 | PRs and CI/CD |
| CDEK MCP and CLI: orders and tracking | no | API key | 0 | orders and labels |
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.