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:

Under the hood it talks to https://api.parcel.royalmail.com/api/v1 using your Click & Drop API key.

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_services and 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_label and 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-mcp

Or run without installing:

npx royalmail-mcp

Configuration

Get your API key from Click & Drop → Settings → API credentials, then set:

RM_API_KEY=your-royal-mail-api

... [View full README on GitHub](https://github.com/catrinmdonnelly/royalmail-mcp#readme)