postnord-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@postnord-mcp Where is my package 84971563697SE?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
postnord-mcp
An MCP (Model Context Protocol) server for PostNord's REST APIs. Lets AI assistants like Claude track shipments, find pickup points, and estimate transit times across the Nordics (Sweden, Norway, Denmark, Finland).
You: Where is my package 84971563697SE?
Claude: → track_shipment("84971563697SE")
Your package left the Oslo terminal this morning and is expected
at your pickup point tomorrow between 08:00 and 16:00.Tools
Tool | Description |
| Track a shipment by shipment ID, item ID (parcel number), or customer reference. Returns full event history and estimated delivery. |
| Find the nearest pickup/drop-off points by address or postal code, with opening hours. |
| Same, but by latitude/longitude. |
| Estimate delivery time between two postal codes for a given PostNord service code. |
Related MCP server: UPS MCP Server
Prerequisites
Node.js 18+
A PostNord API key — free. All PostNord API plans are free of charge; the key is emailed to you after you register for a plan. Which registration to use depends on whether you have a company/organization number (see below).
Getting an API key
PostNord's developer portal is business-oriented. There is no consumer plan — every option authenticates with an API key sent as the apikey query parameter, but the registration paths differ:
Path | Where | Needs org number? | Real shipment data? | Environment |
Sandbox | No — "Company Name" is free text | No (test data only) |
| |
Customer / Partner Plan | Yes | Yes |
|
Sandbox is the quickest way to verify the server works end to end. The signup form only asks for a name, email, username, and password; set
POSTNORD_SANDBOX=true(see Configuration) to point the server at the test host.Customer Plan vs Partner Plan — both are free. "Customer" is for using the APIs for your own business; "Partner" is for building a platform that serves other PostNord customers. Both require a company name and organization number at signup. If you run a sole proprietorship you already have an org number and can use the Customer Plan.
No company? For real (non-sandbox) tracking without an organization number, email api.support@postnord.com and ask whether the free Customer Plan can be granted to an individual/hobby project.
The Booking API requires a separate business agreement and OAuth2 client credentials, and is not included in this server.
Installation
git clone https://github.com/fredrsat/postnord-mcp.git
cd postnord-mcp
npm install
npm run buildUsage
Claude Desktop
Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"postnord": {
"command": "node",
"args": ["/path/to/postnord-mcp/dist/index.js"],
"env": {
"POSTNORD_API_KEY": "your-api-key"
}
}
}
}Claude Code
claude mcp add postnord --env POSTNORD_API_KEY=your-api-key -- node /path/to/postnord-mcp/dist/index.jsAny other MCP client
The server speaks MCP over stdio. Start it with POSTNORD_API_KEY set:
POSTNORD_API_KEY=your-api-key node dist/index.jsConfiguration
All configuration is via environment variables:
Variable | Required | Default | Description |
| ✅ | — | Your API key from the developer portal |
|
| Set to | |
|
| Override the API base URL entirely | |
|
| Language for human-readable strings: |
Example prompts
Once connected, try asking your assistant:
"Track package 84971563697SE"
"Where's the nearest PostNord pickup point to Karl Johans gate 1, Oslo?"
"Find service points near postal code 111 20 in Sweden"
"How long does MyPack Collect take from 0150 Oslo to 5003 Bergen?"
API notes
PostNord authenticates with the API key as an
apikeyquery parameter on every request.Tracking uses Track & Trace v5 (
/rest/shipment/v5/trackandtrace/findByIdentifier.json); service points use Business Location v5.The transit time endpoint varies by plan and agreement — if
get_transit_timereturns a 404, check the exact path in the swagger spec under your account on the developer portal and adjustsrc/postnord.ts.Rate limits depend on your plan (Sandbox / Free / Premium). API errors are returned to the model as tool errors with the response body included, so the assistant can explain what went wrong.
Development
npm run dev # tsc --watch
npm run build # compile to dist/The code is small on purpose: src/postnord.ts is a thin API client, src/index.ts registers the MCP tools. Adding a new PostNord endpoint is a method on the client plus a registerTool call.
You can test the server manually with the MCP Inspector:
POSTNORD_API_KEY=your-api-key npx @modelcontextprotocol/inspector node dist/index.jsRoadmap
Booking API support (requires a PostNord business agreement + OAuth2 client credentials)
Publish to npm for
npx postnord-mcpusageResponse trimming — return curated fields instead of raw API JSON to save tokens
Contributions welcome — open an issue or PR.
Disclaimer
This is an unofficial, community-built integration. It is not affiliated with or endorsed by PostNord AB. Use of the PostNord APIs is subject to their terms of service.
License
Available Tools
4 toolsfind_service_pointsFind service pointsA
Find the nearest PostNord service points (pickup/drop-off locations) by address or postal code. Returns names, addresses, opening hours, and coordinates.
Inputs: countryCode (required), city, limit, postalCode, +2 more.
find_service_points_by_coordinatesFind service points by coordinatesA
Find the nearest PostNord service points (pickup/drop-off locations) by geographic coordinates (WGS84 latitude/longitude).
Inputs: latitude (required), longitude (required), countryCode (required), limit.
get_transit_timeGet transit timeA
Estimate PostNord transit time between two postal codes for a given service code. Service codes depend on your PostNord agreement (e.g. 19 for MyPack Collect).
Inputs: serviceCode (required), originPostalCode (required), originCountryCode (required), destinationPostalCode (required), +2 more.
track_shipmentTrack shipmentA
Track a PostNord shipment by shipment ID, item ID (parcel number), or customer reference. Returns the full tracking history with status events, estimated delivery time, and delivery details.
Inputs: id (required), locale.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
track_shipment and get_transit_time are clearly distinct, but find_service_points and find_service_points_by_coordinates perform the same lookup with different input types. The suffix and explicit descriptions prevent serious confusion.
All tool names follow a lowercase verb_noun pattern with consistent snake_case. find_service_points_by_coordinates is longer but still fits the same convention.
Four tools is well within the ideal range and each covers a meaningful PostNord workflow: tracking, service point lookup, and transit time estimation. There is no obvious redundancy.
The set covers the core read-only PostNord use cases well, especially tracking and pickup locations. It lacks a way to enumerate valid service codes or create shipments, but those are minor gaps for typical tracking and collection queries.
Related MCP Connectors
Manage orders, book shipments, print labels and track parcels with PostNord, GLS, Bring and DHL.
Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses
Track packages across 1,300+ global carriers with real-time status and AI-powered delivery dates.
Quote, buy and track real shipping labels (GLS, PostNord, DHL, UPS…) in DK, GB, DE, NO, NL.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to track and manage deliveries by interacting with the Parcel delivery tracking API. Users can add new shipments, retrieve active delivery statuses, and look up carrier information through natural language.2MIT
- AlicenseAqualityDmaintenanceEnables AI agents to create shipments, track packages, get rates, validate addresses, schedule pickups, and find UPS locations via the UPS API.910 npm2MIT

Easyship MCPofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage global shipping operations, including rate comparison, shipment creation, label purchasing, tracking, pickup scheduling, address validation, billing, and analytics, via natural language.MIT- AlicenseAqualityBmaintenanceEnables AI assistants to query and manage logistics shipment data, supporting operations like tracking, quoting, and performance analysis via nine tools backed by a demo dataset or a REST API.9253 npmMIT