Skip to content

MCP server

PayPal MCP Server

PayPal's official MCP server that lets AI clients create and manage invoices, orders, refunds, disputes, products, subscriptions and shipment tracking via PayPal APIs.

  • Official
  • Runs locally
  • API key

Repository and documentation last checked Built from public product pages and documentation. SourcesClaim this listing

ecommerceguide summary

PayPal's official MCP server gives AI clients tool access to PayPal APIs: create, send and cancel invoices, create and pay orders, issue and look up refunds, review disputes, manage catalogue products, create and cancel subscription plans, record shipment tracking and list transactions. It runs locally over stdio via npx -y @paypal/mcp, authenticated with a PAYPAL_ACCESS_TOKEN generated from your client ID and secret, with SANDBOX or PRODUCTION set per environment. Apache-2.0 licensed.

Why it stands out

Published by PayPal itself under the paypal GitHub organisation as the npm package @paypal/mcp.

What PayPal MCP Server does

ecommerceguide editorial
  • Maintained by PayPal in the paypal/paypal-mcp-server repository, Apache-2.0 licensed
  • Installs with npx -y @paypal/mcp --tools=all, Node 18 or later
  • Read and write tools: create_invoice, pay_order, create_refund, cancel_subscription
  • Dispute tools list, retrieve and accept claims; list_transactions covers reporting
  • Setup steps documented for Claude Desktop, Cursor and VS Code
  • Auth via PAYPAL_ACCESS_TOKEN env var, PAYPAL_ENVIRONMENT selects sandbox or production
  • Local stdio server; no hosted remote endpoint offered

How ecommerce teams could use it

ecommerceguide editorial

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

  1. Subscription brand taking payments through PayPal

    Support staff use an MCP client to handle billing exceptions, cancelling a subscription or issuing a partial refund

    Intended outcomeThe server calls cancel_subscription, create_refund and show_subscription_details against the PayPal account in use

  2. Team building invoicing into a seller onboarding flow

    Developers test invoice generation from Cursor against PayPal sandbox credentials

    Intended outcomecreate_invoice, send_invoice and generate_invoice_qr_code run with PAYPAL_ENVIRONMENT set to SANDBOX

  3. Merchant shipping physical goods and fielding PayPal disputes

    An operator reviews open disputes and adds tracking for recent orders

    Intended outcomelist_disputes, get_dispute and create_shipment_tracking return and record the data through PayPal APIs

Who it suits

ecommerceguide editorial

Best for

PayPal is the account you work in and you want first-party tools for invoices, orders, refunds, disputes and subscriptions inside Claude Desktop, Cursor or VS Code.

Probably not for

You need a hosted remote endpoint, OAuth rather than an access token set in config, or coverage of a processor other than PayPal, such as Stripe.

Business size
Any stageThe server is a free Apache-2.0 npm package run locally, with no revenue or team bound stated by PayPal.

Technical details

From the vendor's own pages

From the server's repository, documentation and MCP directory listings.

What an agent can do
Payments, Orders, Manage products, Shipping and fulfilment, Analytics
Transport
stdio (local)
Authentication
API keySet PAYPAL_ACCESS_TOKEN (generated from client ID/secret) and PAYPAL_ENVIRONMENT in the config env.
Package
@paypal/mcp (npm)
Language
JavaScript
Licence
Apache-2.0
Repository last updated
28 Oct 2025

Connect PayPal MCP Server

Third-party data

Setup documented for

Install command
npx -y @paypal/mcp --tools=all

Command as listed on the repository README, not tested by ecommerceguide. Check the official documentation (opens in a new tab) for configuration and credentials before running it.

Works with

Ecommerce platforms and services

  • PayPal logoPayPal

Systems this server reads from or writes to.

Often used alongside

ecommerceguide editorial

Categories and use cases