royalmail-mcp
This server lets an AI book, label, track, and cancel Royal Mail/Parcelforce shipments via Click & Drop, and list supported services.
book_order: create an order with service, weight, recipient, and optional sender/reference/package details; returns anorderIdentifier.get_label: retrieve a base64-encoded PDF label for an order (README notes labels require an OBA account).track_order: get current status and tracking details for an order.cancel_order: cancel an order before it is manifested/despatched.list_services: list supported Royal Mail/Parcelforce services and Service Register codes.Note: the README also describes
book_batch_and_label, but it is not present in the supplied server schema.
royalmail-mcp
Book, label, track and cancel Royal Mail and Parcelforce shipments from any MCP-compatible AI such as Claude, Cursor, or Windsurf.
Verified against the live Click & Drop API (April 2026). Booking, tracking and cancellation tested end-to-end. Label retrieval verified against the spec for OBA accounts.
What it does
Exposes six tools to any AI that speaks MCP:
Tool | What it does |
| Create an order in Click & Drop. Returns an |
| Book many orders at once and get back a single merged PDF of every label, ready to print. |
| Save the postage label to disk as a PDF. Requires an OBA account (see below). |
| Current status, tracking number and despatch date. |
| Cancel an order before it's manifested. |
| Every Royal Mail and Parcelforce service this MCP supports, with codes. |
Under the hood it talks to https://api.parcel.royalmail.com/api/v1 using your Click & Drop API key.
Related MCP server: UK Property Intelligence
Example prompts
Once the MCP is installed in your AI client, you can say things like:
"Book a 1st class letter to Alex Taylor, 45 High Street, Manchester M1 1AA, 80 grams. Reference it ORDER-1842."
"Ship these three orders via Tracked 48 and give me the orderIdentifiers." (paste a list of addresses)
"Book Special Delivery by 1pm with £1,000 compensation to this address, then fetch the label."
"Cancel order 1004. The customer sent the wrong postcode."
"What's the cheapest signed-for service for a 500g parcel?" (AI calls
list_servicesand reasons)
"Track orders 1002, 1003 and 1004 and summarise where each one is."
"Here are ten orders, book them all on Royal Mail Tracked 24 and give me one PDF I can print." (AI calls
book_batch_and_labeland returns the path to a merged PDF.)
The AI handles address parsing, service selection and error recovery. You handle the business decisions.
Workflow ideas for businesses
Plugged into any AI agent, this MCP can automate real shipping operations:
Daily order fulfilment. Every morning, your AI reads new orders from Shopify, WooCommerce or a spreadsheet, books each one via Royal Mail at the right service level, and posts tracking numbers back to the customer.
Customer service triage. When a customer emails "where's my parcel?", your AI calls
track_order, summarises the latest status in plain English, and drafts a reply.Multi-carrier picking. Installed alongside apc-mcp, your AI can book each parcel with whichever carrier you tell it to. Neither tool returns prices, so the choice is yours.
Bulk fulfilment days. For sale events or subscription-box drops, give your AI a CSV of hundreds of orders. It books up to 50 at a time and reports the result, so check the list before you approve because every booking costs money.
Compatibility
Works with any MCP client that supports stdio transport:
Claude Desktop
Cursor
Windsurf
Claude Code
Zed
ChatGPT, Smithery and other remote-only MCP clients need an HTTP transport, which isn't included yet. If that matters to you, open an issue so I can prioritise it.
Install
npm install -g royalmail-mcpOr run without installing:
npx royalmail-mcpConfiguration
Get your API key from Click & Drop → Settings → API credentials, then set:
RM_API_KEY=your-royal-mail-api-key
RM_BASE_URL=https://api.parcel.royalmail.com/api/v1Either in a .env file next to the server, or via your MCP client's config (see below).
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"royalmail": {
"command": "npx",
"args": ["-y", "royalmail-mcp"],
"env": {
"RM_API_KEY": "your-royal-mail-api-key"
}
}
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"royalmail": {
"command": "npx",
"args": ["-y", "royalmail-mcp"],
"env": {
"RM_API_KEY": "your-royal-mail-api-key"
}
}
}
}Supported services
Key | Royal Mail service | Code |
| 1st Class |
|
| Signed For 1st Class |
|
| 2nd Class |
|
| Tracked 24 |
|
| Tracked 48 |
|
| Special Delivery by 1pm (£750) |
|
| Special Delivery by 1pm (£1,000) |
|
| Special Delivery by 1pm (£2,500) |
|
| Parcelforce express24 |
|
| Parcelforce express48 |
|
| International Tracked |
|
Plus 22 more, including signed-for variants, age-verification services, and Parcelforce international. Run list_services for the full list.
You can pass either the friendly key (first-class) or the raw Service Register code (OLP1). Both work. Which services your account can use depends on what's enabled in Click & Drop → Settings → Shipping services.
Limitations
Labels require an OBA account
get_label only works for customers on a Royal Mail Online Business Account (OBA), the invoiced business account. Standard Pay-as-you-go Click & Drop accounts will get 403 Forbidden (Feature not available) on get_label.
Booking, tracking and cancelling work on all account types. If you don't have an OBA you can still automate the order creation via this MCP, then print labels in the Click & Drop UI manually.
Register for OBA at auth.parcel.royalmail.com/register/oba.
OBA users: enable auto-apply-postage
If you're on OBA, also tick "Apply postage automatically on orders imported via API" in Click & Drop → Settings. Without it, orders stay as drafts and get_label returns "Label generation only available for orders with postage applied status".
Security
Your API key grants full access to your Click & Drop account. Treat it like a password.
Never commit
.envto git. The.gitignorein this repo already excludes it.Don't paste your key into chat messages or shared documents.
Rotate it at Click & Drop → Settings → API credentials if it's ever exposed.
Privacy & data handling
This MCP runs entirely on your machine. No customer data, credentials or API traffic flows through any server owned or operated by the author.
The data path is:
Shipping details you give your AI assistant go to your AI provider (e.g. Anthropic, if you're using Claude) under your account.
Booking requests go to Royal Mail Click & Drop using your API key.
Labels are saved to your local disk at
~/Downloads/parcel-toolkit/(overridable via thePARCEL_TOOLKIT_LABELS_DIRenv var).
If you're using this in a UK business, you are the data controller under UK GDPR. Practical recommendations:
Use Claude Team, Claude Enterprise, or the Claude API directly, not consumer Claude.ai, so a Data Processing Agreement with Anthropic is in place. On consumer tiers, turn off "Help improve Claude" in Privacy settings at minimum.
List Anthropic and Royal Mail as subprocessors in your privacy policy, the same way you would list a payment provider or email service.
Avoid using this tool for special-category data (health, biometric, children's data) without additional legal review.
This software is provided as-is under the MIT licence. The author is not a data processor and takes no responsibility for your compliance obligations, those sit with you as the data controller.
Contributing
Issues and pull requests are welcome at github.com/catrinmdonnelly/royalmail-mcp. If Royal Mail changes their API, or you hit an edge case on your account type, please open an issue with the request body you sent and the response you got (scrub your API key first).
Companion MCP
For APC Overnight, see apc-mcp.
Disclaimer
This project is not affiliated with, endorsed by, or sponsored by Royal Mail Group Ltd. "Royal Mail", "Parcelforce" and "Click & Drop" are trademarks of their respective owners. Use at your own risk.
Licence
MIT. See LICENSE.
Available Tools
5 toolsbook_orderA
Book a Royal Mail shipment via Click & Drop. Returns an orderIdentifier used to retrieve the label.
Inputs: service (required), weightGrams (required), recipient (required), packageFormat, +13 more.
cancel_orderA
Cancel a Royal Mail Click & Drop order. Must be done before the order is manifested/despatched.
Inputs: orderIdentifier (required).
get_labelA
Get the shipping label for a Royal Mail Click & Drop order. Returns base64-encoded PDF label.
Inputs: orderIdentifier (required).
list_servicesA
List supported Royal Mail and Parcelforce services with their Service Register codes. Availability depends on your Click & Drop account.
Inputs: no named parameters.
track_orderA
Get the current status and tracking details for a Royal Mail Click & Drop order.
Inputs: orderIdentifier (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation (booking, canceling, label retrieval, service listing, tracking) with no overlapping purposes. The descriptions clearly differentiate their roles.
Tools follow a consistent verb_noun pattern (book_order, cancel_order, get_label, list_services, track_order). 'get_label' uses 'get' while others use verbs like 'book' and 'cancel', but the pattern is clear and predictable.
With 5 tools covering the essential operations for Royal Mail shipments (create, cancel, label, tracking, service discovery), the count is well-scoped and appropriate for the server's purpose.
The set covers the core lifecycle of an order (create, cancel, label retrieval, tracking). Missing features like updating an order or manifesting are minor gaps that can be worked around, as most workflows are supported.
Maintenance
Related MCP Connectors
Furgonetka MCP Server is an extension for LLMs (such as Claude) that integrates AI assistants with Poland's most popular courier brokerage platform. The server enables models to interact directly with services from various couriers (including InPost, DPD, DHL, UPS, and Poczta Polska) through a single, unified interface. With this integration, your AI stops just "writing about logistics" and starts actually managing it.
Pirate Ship MCP server for ChatGPT, Claude and any AI agent: get rates, buy labels in bulk, import orders, track shipment and refund labels in your own Pirate Ship account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Pirate Ship yourself; Cotlet does not store your password and you need no Pirate Ship API key. About the official Pirate Ship API: Pirate Ship has no API (checked 11 Oct 2026). Its help center says so and points to store integrations and spreadsheet uploads instead. Setup and FAQ: https://cotlet.dev/integrations/pirate-ship-api-mcp-server
MCP server for EasyPost — rate shipments, buy & refund labels, track packages, verify addresses.
Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for APC Overnight. Book, label, track and cancel UK parcel shipments from any MCP-compatible AI.6293 npm2MIT
- AlicenseNot gradedqualityDmaintenanceUK property data MCP server for AI hosts (Claude, ChatGPT). Wraps Land Registry, Rightmove, EPC, rental yields, stamp duty, and Companies House into 13 tools.2MIT
- AlicenseBqualityDmaintenanceAn MCP server that wraps the ShipSaving logistics REST API, enabling AI assistants like Claude to perform shipping operations through natural language.3040 npmMIT
- AlicenseAqualityDmaintenanceMCP server for tracking Japanese logistics carriers (Yamato, Sagawa, Japan Post) via mock or AfterShip adapter. Enables AI agents to query shipment status and history in natural language.3MIT