Royalmail MCP
Book, label, track and cancel Royal Mail and Parcelforce parcels from an AI client
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Royalmail MCP
Royalmail MCP is an open-source MCP server for freight and logistics. It runs locally on your machine and is started by your AI client.
The server talks to the Royal Mail Click & Drop API with your own API key and exposes six tools. book_order creates an order, book_batch_and_label books many at once and returns a single merged PDF of labels, get_label saves a postage label to disk, track_order reports status and despatch date, cancel_order cancels before manifesting, and list_services gives every supported service with its code. The README says booking, tracking and cancelling were tested end to end against the live API in April 2026.
A few limits matter. Labels only work on a Royal Mail Online Business Account; standard pay-as-you-go accounts get a 403 on get_label, though they can still book, track and cancel and print labels in Click & Drop. OBA users must also tick the setting that applies postage automatically to API orders. Bulk runs book up to 50 orders at a time, and every booking costs money, so check the list first. Neither this server nor its sister apc-mcp returns prices.
It supports 11 named services including 1st and 2nd Class, Tracked 24 and 48, Special Delivery tiers and Parcelforce express, plus 22 more. It runs entirely on your machine over stdio; labels land in a local downloads folder, and no author-run server sees your data.
Install
Run in a terminal
claude mcp add royalmail-mcp --env RM_API_KEY='<RM_API_KEY>' -- npx -y royalmail-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"royalmail-mcp": {
"command": "npx",
"args": [
"-y",
"royalmail-mcp"
],
"env": {
"RM_API_KEY": "<RM_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"royalmail-mcp": {
"command": "npx",
"args": [
"-y",
"royalmail-mcp"
],
"env": {
"RM_API_KEY": "<RM_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"royalmail-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"royalmail-mcp"
],
"env": {
"RM_API_KEY": "<RM_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"royalmail-mcp": {
"command": "npx",
"args": [
"-y",
"royalmail-mcp"
],
"env": {
"RM_API_KEY": "<RM_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"royalmail-mcp": {
"command": "npx",
"args": [
"-y",
"royalmail-mcp"
],
"env": {
"RM_API_KEY": "<RM_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
RM_API_KEYYour Royal Mail Click & Drop API key, from Settings then API credentials.Required
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- book_order
- Creates an order in Click & Drop.
- book_batch_and_label
- Books many orders and returns one merged label PDF.
- get_label
- Saves the postage label as a PDF; needs an OBA account.
- track_order
- Current status, tracking number and despatch date.
- cancel_order
- Cancels an order before it is manifested.
- list_services
- Lists supported services with codes.
What it does
- Book orders
- book_order creates a Click & Drop order and returns its identifier.
- Batch labels
- Books many orders and merges every label into one printable PDF.
- Tracking
- track_order returns status, tracking number and despatch date.
- Cancellation
- cancel_order works until an order is manifested.
- Service list
- list_services shows Royal Mail and Parcelforce services with codes.
- Local-only
- Runs on your machine; the only calls go to Royal Mail and your AI provider.
Good for
- Book a Special Delivery parcel from a typed address
- Fulfil a daily batch of shop orders
- Answer a where-is-my-parcel email using tracking
- Cancel an order sent to the wrong postcode
- Print a merged label sheet for a sale day
Pricing
Open source
Free to use; you need a Royal Mail Click & Drop account
Royalmail MCP FAQ
What credentials does it need?
A Royal Mail Click & Drop API key, set as RM_API_KEY, from Settings then API credentials.
Why does get_label return 403?
Label retrieval needs an Online Business Account; standard pay-as-you-go accounts cannot use it.
Which clients work?
Any stdio MCP client such as Claude Desktop, Cursor, Windsurf, Claude Code and Zed; remote-only clients like ChatGPT are not supported yet.
Does it show prices?
No. It does not return prices, so the choice of service is yours.
Is Royalmail MCP free?
Yes. Royalmail MCP is open source, so you can use and self-host it for free.
How do I add Royalmail MCP to Claude Code?
Run this command in your terminal: claude mcp add royalmail-mcp --env RM_API_KEY='<RM_API_KEY>' -- npx -y royalmail-mcp
What are the best alternatives to Royalmail MCP?
The closest alternatives to Royalmail MCP are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Zovo Product Recall Check and Trackkr MCP Server — Smart Lockerless Parcel Management.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
