cdek-mcp
MCP server for the CDEK API: tariff quotes, pickup point search, tracking, order creation, courier pickup and waybill printing
Install
{
"mcpServers": {
"cdek": {
"command": "npx",
"args": ["-y", "@theyahia/cdek-mcp"],
"env": {
"CDEK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"CDEK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"CDEK_SANDBOX": "true"
}
}
}
}The same block works in .cursor/mcp.json and .windsurf/mcp.json. In .vscode/mcp.json the top-level key is servers. Remove CDEK_SANDBOX for production.
This is third-party code. Review the repository files before installing.
What it does
The server wraps CDEK API v2 and gives the agent 16 tools covering the whole shipment flow. The agent can quote cost and delivery time for one tariff or compare all tariffs on a route, and look up cities, regions and pickup points by city or coordinates. It can create, fetch and cancel orders, track a waybill, book a courier, get barcodes and PDF receipts, and register webhooks. Both the test and production environments are supported, and the OAuth token refreshes automatically. Four Claude Code skills are included: delivery quote, pickup point search, shipping and tracking.
Who it is for. For online stores, sellers and developers who ship parcels with CDEK.
Good fit when
- You need to compare tariffs and delivery times between cities
- You need to find nearby pickup points or parcel lockers
- You need to track a parcel by waybill number
- You want to create a shipment and book a courier from the agent
Not a fit when
- You have no CDEK contract or API keys
- You need bulk order export from an ERP: a ready store integration fits better
Example request
How much and how long to ship a 2 kg parcel from Moscow to Kazan? Compare tariffsLimitations
Requires Client ID and Client Secret from the CDEK account. The shared sandbox key pair changes from time to time, and then the sandbox returns 401 until you get your own test keys. In production, orders and courier pickups are real and billed under your contract.
How to disable. Remove the cdek block from your MCP client config, or run claude mcp remove cdek if you added it through Claude Code.
MCP
- Transport
- stdio, http
- Authentication
- OAuth
| Environment variables | |
|---|---|
| CDEK_CLIENT_ID required, secret | Client ID from the CDEK account |
| CDEK_CLIENT_SECRET required, secret | Client Secret from the CDEK account |
| CDEK_SANDBOX | true for the api.edu.cdek.ru test environment |
| HTTP_PORT | HTTP transport port, enables HTTP mode |
Security check
- In production it creates and cancels real orders and courier pickups billed under your contract
- Holds CDEK API secrets
README in short
The README groups the 16 tools into tariffs, orders, tracking, geography, printing, courier and webhooks. It gives configs for Claude Desktop, Cursor, Windsurf and VS Code, an HTTP launch and an env var table. It also covers the sandbox with a shared test account, how OAuth works and sample prompts. Part of the WWmcp series, MIT licensed.
FAQ
Where do I get keys?
In the CDEK account, in the integration section under API keys.
Can I try it without real orders?
Yes, with CDEK_SANDBOX=true the server uses the api.edu.cdek.ru test environment.
Related
An MCP server with n8n node and template knowledge: the agent picks nodes, validates configs and, with API access, creates workflows in your n8n
Zapier's official MCP plugin: the agent gets actions across thousands of apps through your Zapier account
Awesome Claude Skills by Composio
Awesome Claude Skills
A curated list of Claude skills and plugins, plus Composio's own automation skills for 78 SaaS apps
A plugin and CLI catalog for agents: generates command-line interfaces for GUI apps like GIMP and Blender and installs ready ones via CLI-Hub