The PayPal MCP server exposes a suite of PayPal API tools via the Model Context Protocol, enabling function calling against PayPal services such as invoices, orders, disputes, shipments, products, subscriptions, and transactions. When launched with npx, the server provides a set of tools under the @paypal/mcp package that you can invoke from your MCP host to perform actions like creating invoices, listing invoices, retrieving invoice details, and sending invoices, as well as managing orders, refunds, disputes, shipments, products, and subscriptions. To integrate, configure the PayPal MCP server in your host (for example Claude Desktop or another MCP host) using the provided environment variable PAYPAL_ACCESS_TOKEN and set PAYPAL_ENVIRONMENT to SANDBOX for testing or PRODUCTION for live usage. After starting, you can issue tool calls from your host to perform the supported PayPal operations. The server supports a comprehensive set of tools, including Invoices, Payments, Dispute Management, Shipment Tracking, Catalog Management, Subscription Management, and Reporting/Insights, enabling end-to-end PayPal workflow automation via function calls.

Prerequisites:

• Node.js installed (Node 18+)
• Access to the PayPal MCP package (@paypal/mcp)

Step-by-step:

1. Install Node.js from https://nodejs.org/ (ensure Node 18+ is installed).
2. Ensure your environment has npm or npx available.
3. Install and run the MCP server with npx as shown in usage:

Code:

Start the MCP server using npx (example)

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

4. Alternatively, configure the host integration file (e.g., Claude Desktop config) with the following:

Code: { "mcpServers": { "paypal": { "command": "npx", "args": [ "-y", "@paypal/mcp", "--tools=all" ], "env": { "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN", "PAYPAL_ENVIRONMENT": "SANDBOX" } } } }

5. Replace YOUR_PAYPAL_ACCESS_TOKEN with your actual token and set PAYPAL_ENVIRONMENT to SANDBOX or PRODUCTION as needed.
6. Restart your MCP host application after configuring.

Prerequisite notes:

• Have a PayPal Developer account and an App with Client ID/Secret to generate access tokens.
• Ensure you’re using the appropriate environment (SANDBOX for testing, PRODUCTION for live).

Tips and common issues:

• Ensure PAYPAL_ACCESS_TOKEN is valid and not expired; tokens typically require handling refresh logic in your host workflow.
• If you prefer not to pass the token via command line, you can set PAYPAL_ACCESS_TOKEN as an environment variable in your system or container where the MCP server runs.
• The integration supports a broad set of tools; consult the PayPal MCP documentation for details on each tool’s required and optional parameters (e.g., list_invoices, create_invoice, get_order, pay_order, create_product, update_product, create_subscription, etc.).
• If you encounter connectivity issues, verify network access to PayPal endpoints and confirm that PAYPAL_ENVIRONMENT is correctly set to SANDBOX or PRODUCTION.
• When using Claude Desktop or similar hosts, you can pass extra options such as --access-token in the tool arguments if supported by your host’s configuration.