CDEK MCP and CLI: orders and tracking
mcp-server-cdek
An MCP server, CLI tool and Pydantic models for the CDEK v2 API: creating orders, barcodes, labels, waybills, pickup point search and a local goods catalog
- 0 ★ on the repository
- Last commit
Broad access
Why this level
- It can create real delivery orders and waybills under live CDEK keys
- The Client ID and Secret give full access to the business account
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-cdekDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- It can create real delivery orders and waybills under live CDEK keys
- The Client ID and Secret give full access to the business account
This is third-party code. Review the repository files before installing.
What it does
The package offers three ways to work with the CDEK v2 API from one codebase: an MCP server for Claude Code and Desktop, a CLI tool for the terminal and scripts, and typed Pydantic models for your own Python programs. Its tools create a delivery order (from or to the sender, to a pickup point or the door), track it by number, download a PDF barcode, label and waybill, and search CDEK pickup points and cities. A local goods catalog lets you describe an item once (weight, dimensions, price) so you do not repeat those parameters on every order. All keys and data stay on the user's machine.
Who it is for. For sellers and small warehouses who want to create and track CDEK orders directly from a chat with an agent or from their own scripts.
Good fit when
- You need to create a delivery order and immediately get a label or waybill
- You need a local catalog of frequently shipped items so you do not re-enter dimensions
- You need a CLI tool for scripted automation, not just conversational use
Not a fit when
- You have no CDEK business account with a Client ID and Client Secret
- You need multi-carrier integration: this server covers only CDEK
Example request
Ship a package to Ivanov at the nearest CDEK pickup point in Moscow and download the labelMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
CDEK_CLIENTrequired, secret- Client ID from the CDEK business account dashboard
CDEK_SECRETrequired, secret- Client Secret from the CDEK business account dashboard
CDEK_SENDER_COMPANY- Default sender company name
Limitations
You need your own CDEK business account with integration keys; the service is not available to individuals without a contract. Sender settings and the goods catalog are stored locally in ~/.config/mcp-server-cdek. Full test coverage is claimed, but real order work needs live or test CDEK keys.
How to disable. Remove the server with claude mcp remove cdek and clear ~/.config/mcp-server-cdek with local settings.
FAQ
Can I use it without installing the package?
Yes, via uvx mcp-server-cdek the server runs with no separate install, you only need uv.
Does it work as a regular command line tool?
Yes, with no arguments it runs the MCP server, and with a command it runs as a CLI, all commands output JSON.
Discussion
No questions or reviews yet.
Related
All CDEK toolsCDEK MCP: calculator and HTTP server
CDEK MCP Server
A CDEK API MCP server with a delivery calculator across all tariffs, courier booking and an HTTP mode for external agent platforms
MCP server for the CDEK API: tariff quotes, pickup point search, tracking, order creation, courier pickup and waybill printing
A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data
Ready-made methods for Telegram, Bitrix24, VK, CDEK, Yandex Disk, databases and other APIs in 1C, OneScript and the oint CLI
1C AI Skills for OpenIntegrations
1C AI Skills for OpenIntegrations (OInt)
Twelve agent skills for the OpenIntegrations library in 1C: Bitrix24 and CDEK, Google and Yandex, Telegram, VK, databases and network protocols
Local MCP server for product search, cart and delivery with Pyaterochka
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| CDEK MCP and CLI: orders and tracking (this card) | no | API key | 0 | |
| 1C-Fresh CLI and MCP server | no | not required | 2 | orders, money |
| SourceCraft MCP and CLI: repos and CI/CD | no | API key | 0 | PRs and CI/CD |
README in short
The README gives a detailed table of contents across three usage modes (MCP, CLI, Pydantic models), tool tables for delivery, the local goods catalog and settings, steps to connect to Claude Code and Claude Desktop via uvx or pip, CLI command examples, and a full environment variable table including default sender settings.