# Royalmail MCP

> Royalmail MCP is an open-source MCP server for freight and logistics. Book, label, track and cancel Royal Mail and Parcelforce parcels from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/catrinmdonnelly/royalmail-mcp
- **MCP Registry name:** io.github.catrinmdonnelly/royalmail-mcp
- **Categories:** [freight and logistics](https://ai-powered.com/categories/freight-and-logistics), [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add royalmail-mcp --env RM_API_KEY='<RM_API_KEY>' -- npx -y royalmail-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "royalmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "<RM_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "royalmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "<RM_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "royalmail-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "<RM_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "royalmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "<RM_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "royalmail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "royalmail-mcp"
      ],
      "env": {
        "RM_API_KEY": "<RM_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Skybridge Ecommerce Example](https://ai-powered.com/mcp/skybridge-ecommerce-example): Skybridge Ecommerce Example is an open-source MCP server for e-commerce.
- [GoAI Moat Tiktok Shop](https://ai-powered.com/mcp/goai-moat-tiktok-shop): GoAI Moat Tiktok Shop is an MCP server for e-commerce.
- [GoAI Moat Xiaohongshu Products](https://ai-powered.com/mcp/goai-moat-xiaohongshu-products): GoAI Moat Xiaohongshu Products is an MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/royalmail-mcp
