catrinmdonnelly avatar

Royalmail Mcp

catrinmdonnelly/royalmail-mcp

Book, track and cancel Royal Mail and Parcelforce shipments from any MCP client.

GitHub stars
3
tools
6
auth
Secret needed
transport
STDIO
env var
1
last updated
Nov 10, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

book_orderCreate an order in Click & Drop. Returns an `orderIdentifier`.

Create an order in Click & Drop. Returns an `orderIdentifier`.

No parameter schema in public metadata yet.

book_batch_and_labelBook many orders at once and get back a single merged PDF of every label, ready to print.

Book many orders at once and get back a single merged PDF of every label, ready to print.

No parameter schema in public metadata yet.

get_labelSave the postage label to disk as a PDF. Requires an OBA account (see below).

Save the postage label to disk as a PDF. Requires an OBA account (see below).

No parameter schema in public metadata yet.

track_orderCurrent status, tracking number and despatch date.

Current status, tracking number and despatch date.

No parameter schema in public metadata yet.

cancel_orderCancel an order before it's manifested.

Cancel an order before it's manifested.

No parameter schema in public metadata yet.

list_servicesEvery Royal Mail and Parcelforce service this MCP supports, with codes.

Every Royal Mail and Parcelforce service this MCP supports, with codes.

No parameter schema in public metadata yet.

Sponsors

Configuration

RM_API_KEY*secret

Your Royal Mail Click & Drop API key, from Settings then API credentials.

Readme

royalmail-mcp

npm version licence node CI

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:


View the full README on GitHub

Details

Repository
github.com/catrinmdonnelly/royalmail-mcp
Package
royalmail-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from catrinmdonnelly