Log inSubmit server
Royalmail MCP logo

Royalmail MCP

by catrinmdonnelly

Book, label, track, and cancel Royal Mail and Parcelforce shipments through Click & Drop using MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Royalmail MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "catrinmdonnelly-royalmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "YOUR_VALUE_HERE",
        "RM_BASE_URL": "YOUR_VALUE_HERE",
        "PARCEL_TOOLKIT_LABELS_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 6 tools correctly (19d ago).

Overview

catrinmdonnelly/royalmail-mcp MCP server connects MCP-compatible AI clients to the Royal Mail Click & Drop API for shipment operations. It provides tools to create orders, retrieve or merge PDF labels, track shipments, cancel eligible orders, and inspect supported services. Configuration uses a Click & Drop API key, with labels saved locally when the account and postage settings support label generation. Reach for it when an agent needs to automate UK or international Royal Mail and Parcelforce fulfilment through a stdio MCP client.

Use cases

  • Book individual Royal Mail shipments from address details
  • Generate one printable PDF for a batch of compatible orders
  • Track Click & Drop orders and summarize their statuses
  • Cancel manifested-ineligible orders before despatch
  • List services and compare available shipping options

Key features

  • Royal Mail and Parcelforce shipment booking
  • Single-order and merged batch label generation
  • Click & Drop order tracking
  • Pre-despatch order cancellation
  • Friendly service keys and raw Service Register codes
  • Local PDF label storage

Tools6

What Royalmail MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 87d

What it can do

From the 6 tools this server returned when we ran it.

Can delete or modify data · 5Read-only tools · 1
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age177 days
Maintainers1

Observed 2026-10-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · royalmail-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads33Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Royalmail MCP works

What catrinmdonnelly/royalmail-mcp MCP server does

catrinmdonnelly/royalmail-mcp MCP server exposes Royal Mail and Parcelforce shipping operations through the Model Context Protocol. It communicates with the Royal Mail Click & Drop API, allowing an MCP-compatible AI client to create shipments, obtain tracking information, cancel eligible orders, and inspect available services.

The server supports 33 services through friendly identifiers and raw Service Register codes. Examples include 1st Class, Signed For, Tracked 24, Tracked 48, Special Delivery, Parcelforce express24 and express48, and International Tracked. The services available to a particular account depend on the shipping services enabled in Click & Drop.

How it works

The AI client calls the server's tools over stdio. A booking request creates a Click & Drop order and returns an orderIdentifier, which can then be supplied to label, tracking, or cancellation operations. Multiple orders can be submitted together when they use the same service, package format, and sender; the server returns a path to one merged PDF containing the resulting labels.

API requests go to https://api.parcel.royalmail.com/api/v1 by default. The server runs on the local machine, while shipping data provided to the AI may also be sent to the configured AI provider. Booking requests and other shipment operations are made against Click & Drop using the supplied API key.

Setup and configuration

Install the package globally with npm install -g royalmail-mcp, or run it without a global installation using npx royalmail-mcp. Obtain an API key from Click & Drop under Settings and API credentials, then provide it as RM_API_KEY. RM_BASE_URL can be set when a different API base URL is needed; the documented default is the Royal Mail API endpoint.

The variables can be placed in a .env file beside the server or passed through the MCP client's configuration. The README includes stdio configurations for Claude Desktop and Cursor. The package requires Node.js 18 or newer.

Labels are written to ~/Downloads/parcel-toolkit/ by default. Set PARCEL_TOOLKIT_LABELS_DIR to change that directory. Keep the API key private: it grants full access to the associated Click & Drop account and should not be committed to source control.

Tools and capabilities

  • book_order creates a Click & Drop shipment and returns its identifier.
  • get_label retrieves a previously booked order's PDF label and saves it locally.
  • book_batch_and_label books multiple compatible orders and produces one merged label PDF.
  • track_order returns current status, tracking number, and despatch date.
  • cancel_order cancels an order before it is manifested or despatched.
  • list_services returns supported Royal Mail and Parcelforce services with their codes.

Limitations and notes

catrinmdonnelly/royalmail-mcp MCP server's label retrieval requires a Royal Mail Online Business Account. Pay-as-you-go Click & Drop accounts can still use booking, tracking, and cancellation, but get_label returns a feature-unavailable error. OBA users must also enable automatic postage application for orders imported through the API; otherwise orders remain drafts and labels cannot be generated.

The package currently supports stdio transport. The documented compatible clients are Claude Desktop, Cursor, Windsurf, Claude Code, and Zed; remote-only clients that require HTTP transport are not supported by the included setup. The software is provided under the MIT licence, and businesses remain responsible for their own UK GDPR obligations when processing customer shipping data.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Royalmail MCP

catrinmdonnelly/royalmail-mcp is an MCP server that connects AI clients to the Royal Mail Click & Drop API. Its main tools book shipments, retrieve or merge PDF labels, track orders, cancel eligible orders, and list Royal Mail and Parcelforce services available to the account.

Install it with `npm install -g royalmail-mcp`, or run it directly with `npx royalmail-mcp`. The package requires Node.js 18 or newer and is configured as a stdio MCP server.

It uses a Click & Drop API key supplied through `RM_API_KEY`. Get the key from Click & Drop under Settings and API credentials, then pass it in the MCP client's environment or a local `.env` file.

Yes, label generation is available through `get_label` and `book_batch_and_label`, but it requires a Royal Mail Online Business Account with automatic postage application enabled. Labels are saved locally by default under `~/Downloads/parcel-toolkit/`.

Yes, it works with Cursor through the documented stdio configuration. Add the server command to Cursor's MCP configuration and provide `RM_API_KEY` in its environment settings.

Related MCP servers

All in Delivery All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRoyalmail MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/catrinmdonnelly-royalmail-mcp?style=directory)](https://allmcps.com/mcp/catrinmdonnelly-royalmail-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/catrinmdonnelly-royalmail-mcp"><img src="https://allmcps.com/api/badge/catrinmdonnelly-royalmail-mcp?style=directory" alt="Royalmail MCP on AllMCPs" /></a>