PayPal MCP Server

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "paypal-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/mcp",
        "--tools=all"
      ],
      "env": {
        "PAYPAL_ENVIRONMENT": "SANDBOX",
        "PAYPAL_ACCESS_TOKEN": "<your-paypal-access-token>"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

• Node.js 18+ (the server runs via npx)
• A PayPal Developer account (for Sandbox) or a PayPal Business account (for Production)
• A Client ID and Client Secret from the PayPal Developer Dashboard (https://developer.paypal.com)
• An OAuth2 access token obtained from those credentials via the client_credentials grant, supplied as PAYPAL_ACCESS_TOKEN

About PayPal MCP Server

Tools & capabilities (12)

When to use it

• Use it when you want an agent to draft, send, and chase invoices (including QR-code invoices) conversationally.
• Use it when building a checkout assistant that creates and captures PayPal orders.
• Use it when you need automated refund handling or dispute triage from a support copilot.
• Use it when managing a product catalog and subscription plans through natural language.
• Use it when adding shipment tracking to orders or pulling transaction reports for reconciliation.

Quick setup

1. 1Create an app in the PayPal Developer Dashboard and copy its Client ID and Secret.
2. 2Exchange the credentials for an access token via the OAuth2 client_credentials grant.
3. 3Add the server to your MCP host: command `npx`, args `["-y", "@paypal/mcp", "--tools=all"]`.
4. 4Set env vars `PAYPAL_ACCESS_TOKEN` and `PAYPAL_ENVIRONMENT` (SANDBOX or PRODUCTION).
5. 5Restart the MCP client and confirm the PayPal tools are listed.
6. 6Test against SANDBOX first, then switch the environment to PRODUCTION when ready.

PayPal MCP Server FAQ