1. Easyship
  2. Settings
  3. Settings

Connect Easyship MCP in Claude

Connect Claude to Easyship's MCP server so your AI agent can compare shipping rates, create shipments, buy labels, schedule pickups, track deliveries, and more — all through natural language.

In this article:

What You Need

  • An active Easyship account
  • Claude Code (CLI), Claude Desktop, or access to claude.ai

Step 1: Get Your Easyship API Token

  1. Go to Easyship Dashboard → Connect and click New Integration
  2. Scroll down to API Integration
  3. In Integration Type, select "I am developing a custom integration"
  4. Name the key Easyship MCP for easy reference
  5. Keep the default version 2024-09 and click Connect
  6. On the page that opens, click Access Token and copy it using the copy button

Required scopes: Make sure your API token has access to the following scopes. Without these, some tools will fail.

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

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

Note: There is no separate test environment for MCP actions. Any action that consumes credits (such as generating labels) will incur real charges. We recommend using a test API token with limited scopes for your first run.

Step 2: Add the Easyship MCP Server

Claude supports MCP via Claude Code (CLI), Claude Desktop, and the Connectors Directory (claude.ai, Claude Desktop, and Cowork — Anthropic's desktop automation tool). Choose the method that fits your setup.

Claude Code

Remote (recommended)

claude mcp add --transport http easyship \
  https://mcp.easyship.com/mcp \
  --header 'Authorization:Bearer YOUR_TOKEN'

Local (uvx)

export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"
claude mcp add easyship -- uvx easyship-mcp

Via plugin

/plugin marketplace add easyship/easyship-mcp-plugin
/plugin install easyship@easyship-mcp-plugin

Claude Desktop (local config)

Edit your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json 
{
  "mcpServers": {
    "easyship": {
      "command": "uvx",
      "args": ["easyship-mcp"],
      "env": {
        "EASYSHIP_API_ACCESS_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with your actual Easyship API token. Save the file and fully restart Claude Desktop (quit, don't just close the window).

Note: Claude Desktop uses the local (uvx) method, which requires uv and Python 3.8+ installed on your machine.

Step 3: Verify the Connection

  • Claude Code: Run /mcp inside a Claude Code session. You should see easyship: connected in the status list.
  • Claude Desktop: After restarting, click the "+" button at the bottom of the chat box and select "Connectors" — this shows all connected MCP servers and their available tools. Alternatively, go to Settings → Developer to check connection status and view server logs.

Step 4: Try It Out

Open a new chat with Claude and try a prompt 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 x 4 x 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 detailed workflows, see the Easyship MCP Developer Docs.

You're all set! Your Claude agent is now connected to Easyship MCP. Start chatting with Claude to access shipping rates, tracking, labels, and more.

API Token Scopes

Your Easyship API token requires the following scopes:

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

One-Click Connector Install — Coming Soon

Anthropic's Connectors Directory is a built-in directory of verified remote MCP integrations available across claude.ai, Claude Desktop, and Cowork on all plans (Free, Pro, Max, Team, and Enterprise). Once Easyship is listed in the directory, users will be able to connect with a single click — no config files or CLI commands required.

How it will work (once listed)

Connect:

  1. In any Claude interface, go to Customize → Connectors
  2. Browse or search for Easyship in the Connectors Directory
  3. Click Connect and follow the OAuth authentication prompts to grant the required permissions

Use:

  1. Click the "+" button at the bottom of the chat box
  2. Select Connectors and toggle Easyship on for your conversation
  3. Start chatting — Claude will have access to all Easyship tools

Can't wait? You can already add Easyship as a custom connector manually on paid plans (Pro, Max, Team, Enterprise). Go to Settings → Connectors → Add custom connector, enter the server URL (https://mcp.easyship.com/mcp), and Claude will discover the authentication flow automatically — follow the OAuth login prompts to connect your Easyship account.

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. If some scopes are missing, certain tools will fail while others work.

What's the difference between connecting via the Easyship connector in Claude vs. the manual setup methods? The Easyship connector (via the Connectors Directory, coming soon) is the simplest path. It's built into claude.ai, Claude Desktop, and Cowork, requires no technical setup, and uses OAuth so you never need to handle an API token directly. The connection is brokered through Anthropic's cloud and works across all your Claude sessions automatically. The manual methods (Claude Code CLI or Claude Desktop config file) are available today and give developers direct control. Both approaches give you the same Easyship capabilities.

What if "easyship" doesn't appear after running /mcp in Claude Code? Double-check the server URL (https://mcp.easyship.com/mcp) and your API token. For the remote method, make sure the --header flag uses Authorization:Bearer YOUR_TOKEN with no space after the colon. You can remove and re-add the server with:

claude mcp remove easyship
claude mcp add --transport http easyship https://mcp.easyship.com/mcp --header 'Authorization:Bearer YOUR_TOKEN'

How do I verify the connection in Claude Desktop? Click the "+" button at the bottom of the chat input box and select "Connectors" — this lists all connected MCP servers and their tools. You can also go to Settings → Developer to see connection status and inspect logs for any server errors.

What if not all tools are loaded?

  • Verify your API token is valid and active
  • For Claude Code: run claude mcp remove easyship and add it again
  • For Claude Desktop: fully quit the app (don't just close the window) and reopen it
  • Check your network connection
  • Go to Settings → Developer in Claude Desktop to review server logs for specific errors

Why is my API token not working? Check the scopes for your token in the Easyship Dashboard under Connect → API. A token might work for some actions but fail for others depending on which scopes it has. For full access to all tools, enable all the scopes listed in Step 1.

What happens if I don't grant all the required scopes? Only the tools that match your granted scopes will work. Other tools will return an error, and the agent will tell you which scope is needed. You can update scopes in the Easyship Dashboard without creating a new token.

Is it safe to store my API token in the Claude Desktop config file? For local personal use, storing the token in the config file is generally acceptable. Avoid checking the config file into version control. For shared or team environments, prefer environment variables. Never paste your token directly into a chat message.

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 for details.

Can I use the same token across multiple clients (Claude Code, Claude Desktop, Cursor, etc.)? Yes. The same API token works across any MCP client. Be mindful of rate limits and avoid running conflicting operations (like editing the same shipment from two clients at once).

What is uv and do I need it? uv is a fast Python package manager required for the local (uvx) installation method. Install it from https://docs.astral.sh/uv/. Python 3.8+ is also required. If you prefer not to install uv, use the remote method for Claude Code instead — it connects directly to the hosted MCP server and has no local dependencies.

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 — this helps us diagnose the issue faster.

Was this article helpful?
0 out of 0 found this helpful
Popular Topics