How to Connect n8n to the Easyship MCP Server

This article explains how to set up the Easyship MCP server in n8n so your automation workflows can manage shipping tasks, including comparing rates, creating shipments, buying labels, scheduling pickups, and tracking deliveries without any direct API integration.

Before You Begin

You'll need:

An active n8n instance (cloud or self-hosted)
Access to your Easyship Dashboard
An Easyship account (API access is available on all plans at no extra cost)

Step 1: Get Your Easyship API Token

Go to your Easyship Dashboard and click Connect
Click New Integration
Scroll down to API Integration
Under Integration Type, select I am developing a custom integration
Name the key Easyship MCP for easy reference
Keep the default version 2024-09 and click Connect
On the next page, click Access Token and copy it using the copy button

Required scopes: Your API token must include the following scopes. Missing scopes will cause some tools to fail while others continue to work.

public.shipment:read              public.shipment:write
public.label:write                public.pickup:read
public.pickup:write               public.address_validation:write
public.address_validation_domestic:write
public.shipment_document:read     public.transaction_record:read
public.analytics:read             public.rate:read
public.track:read

You can check and update scopes at any time in Dashboard → Connect → API without creating a new token.

Step 2: Add the Easyship MCP Server to n8n

Open your workflow in n8n
Add a new node and search for MCP Client
In the MCP Client node, configure the following:
- Server URL → https://mcp.easyship.com/mcp
- Authentication → Select Bearer Token
- Token → Paste your Easyship API token from Step 1

Security: Never share your API token in a chat window or commit it to version control. If you accidentally expose it, revoke and rotate your key immediately in the Easyship Dashboard under Connect → API.

Step 3: Select an Action

Once connected, the MCP Client node will auto-load all available Easyship tools. Choose an action such as Create Shipment, Get Shipping Rates, Generate Label, Track Shipment, or Validate Address.

Step 4: Try It Out

Trigger your workflow and prompt the MCP Client with something like:

I want to ship a parcel from New York, USA to Toronto, Canada. Origin: 350 5th Avenue, New York, US 10001. Destination: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Parcel: 1.98 lb, 6 × 4 × 2 cm. Item: Business documents, quantity 1, HS Code 4911.99, declared value $1.00 USD, category documents, DDU. Show me the cheapest and best value shipping options with delivery times and courier names.

For a full list of available tools and workflows, see the Easyship MCP Developer Docs.

Example Workflows

1. Shopify Order → Automated Shipping and Tracking

Tools: Shopify + Easyship MCP + n8n

Trigger: New order in Shopify
Extract order and shipping details
MCP Client → Create Shipment
MCP Client → Generate Label
Store tracking ID and send tracking email to customer

Outcome: Fully automated fulfillment pipeline — no manual label generation, faster dispatch, scales with order volume.

2. Zendesk Ticket → Shipment Status Automation

Tools: Zendesk + Easyship MCP

Trigger: New support ticket ("Where is my order?")
Extract order ID from ticket
MCP Client → Track Shipment
Respond automatically with tracking link and status

Outcome: Instant support replies, eliminates repetitive WISMO tickets, reduces agent workload.

3. Post-Purchase Communication Workflow

Tools: Easyship MCP + n8n + email/SMS tools (e.g. Klaviyo, WhatsApp)

Trigger: Shipment created
MCP Client → Get tracking info
Send automated messages: order shipped confirmation, delivery ETA, delivery confirmation

Outcome: Better customer experience, increased engagement, fewer support queries.

Best Practices

Always validate addresses before creating a shipment
Store tracking IDs centrally in your database or CRM
Use retries for failed API or tool actions
Add fallback logic for edge cases (e.g. courier unavailable)
Log every shipment event for easier debugging

FAQs

Can I use an existing API token, or do I need a new one?

You can use an existing token from your Easyship account. Just make sure it has all the required scopes listed in Step 1.

What if the MCP Client node can't connect?

Double-check the server URL (https://mcp.easyship.com/mcp) and your API token. Make sure Authentication is set to Bearer Token with no extra spaces in the token. Delete the connection and re-add it if the issue persists.

What if not all tools are loaded?

Verify your API token is valid and all required scopes are enabled. Then disconnect and reconnect the MCP Client node in n8n.

Why is my API token not working?

Check the scopes for your token in the Easyship Dashboard under Connect → API. Enable all the scopes listed in Step 1 for full access.

Do I need to pay for the API token?

No. Easyship provides API access across all plans at no extra cost. If you exceed the included API limits for your plan, overage fees may apply. See [pricing plans and included limits].

Can I use the same token across multiple tools?

Yes. The same API token works across any MCP client. Be mindful of rate limits and avoid running conflicting operations simultaneously.

Need Further Assistance?

If you're experiencing an error that isn't covered above, submit a bug report. Include the tool name, error code, and request ID from the error response - these help us diagnose the issue faster.