cdek-mcp

MCP server for the CDEK API: tariff quotes, pickup point search, tracking, order creation, courier pickup and waybill printing

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • In production it creates and cancels real orders and courier pickups billed under your contract
  • Holds CDEK API secrets
All reasons and checks
Russian stack

theyahia/cdek-mcp

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/cdek-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • In production it creates and cancels real orders and courier pickups billed under your contract
  • Holds CDEK API secrets

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 tariffs

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

Limitations

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.

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.

Discussion

No questions or reviews yet.

Russian stack

A CDEK API MCP server with a delivery calculator across all tariffs, courier booking and an HTTP mode for external agent platforms

MCP serverBroad access
Russian stack

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

MCP serverBroad access
Russian stack

A monorepo of MCP servers for Russian and CIS APIs: payments, CRM, marketplaces, delivery, HR and reference data

MCP serverBroad access36Repository stars
Russian stack

Ready-made methods for Telegram, Bitrix24, VK, CDEK, Yandex Disk, databases and other APIs in 1C, OneScript and the oint CLI

CLIBroad access687Repository stars

1C AI Skills for OpenIntegrations

1C AI Skills for OpenIntegrations (OInt)

Russian stack

Twelve agent skills for the OpenIntegrations library in 1C: Bitrix24 and CDEK, Google and Yandex, Telegram, VK, databases and network protocols

SkillMinimal access

MCP for Yandex Delivery

A1 Яндекс Доставка MCP

Russian stack

MCP server for Yandex Delivery B2B API: cost calculation, order placement, and tracking for same-day and next-day deliveries across Russia

MCP serverBroad access

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.

README badge

Report a problem

Foxx AIcdek-mcp
Foxx AI

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.