
Paypal Mcp Server
This connects Claude directly to PayPal's APIs for payments, invoicing, subscriptions, and order management. You get 30+ tools out of the box: create and send invoices, process orders and refunds, manage disputes, track shipments, handle catalog products, and run subscription billing. It works in both sandbox and production modes, authenticating with PayPal access tokens you generate from your developer dashboard. The setup is straightforward through npx, and you can enable all tools at once or pick specific ones. Useful when you're building payment workflows, need to automate invoice generation, or want conversational access to PayPal operations without writing integration code yourself.
- GitHub stars
- 10
- tools
- 30
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Oct 28, 2025
Tools
30 toolsPublic tool metadata for what this MCP can expose to an agent.
create_invoiceCreate a new invoice in the PayPal system
Create a new invoice in the PayPal system
No parameter schema in public metadata yet.
list_invoicesList invoices with optional pagination and filtering
List invoices with optional pagination and filtering
No parameter schema in public metadata yet.
get_invoiceRetrieve details of a specific invoice
Retrieve details of a specific invoice
No parameter schema in public metadata yet.
send_invoiceSend an invoice to recipients
Send an invoice to recipients
No parameter schema in public metadata yet.
send_invoice_reminderSend a reminder for an existing invoice
Send a reminder for an existing invoice
No parameter schema in public metadata yet.
cancel_sent_invoiceCancel a sent invoice
Cancel a sent invoice
No parameter schema in public metadata yet.
generate_invoice_qr_codeGenerate a QR code for an invoice
Generate a QR code for an invoice
No parameter schema in public metadata yet.
create_orderCreate an order in PayPal system based on provided details
Create an order in PayPal system based on provided details
No parameter schema in public metadata yet.
get_orderRetrieve the details of an order
Retrieve the details of an order
No parameter schema in public metadata yet.
pay_orderProcess payment for an authorized order
Process payment for an authorized order
No parameter schema in public metadata yet.
create_refundProcess a refund for a captured payment.
Process a refund for a captured payment.
No parameter schema in public metadata yet.
get_refundGet the details for a specific refund.
Get the details for a specific refund.
No parameter schema in public metadata yet.
list_disputesRetrieve a summary of all open disputes
Retrieve a summary of all open disputes
No parameter schema in public metadata yet.
get_disputeRetrieve detailed information of a specific dispute
Retrieve detailed information of a specific dispute
No parameter schema in public metadata yet.
accept_dispute_claimAccept a dispute claim
Accept a dispute claim
No parameter schema in public metadata yet.
create_shipment_trackingCreate a shipment tracking record
Create a shipment tracking record
No parameter schema in public metadata yet.
get_shipment_trackingRetrieve shipment tracking information
Retrieve shipment tracking information
No parameter schema in public metadata yet.
create_productCreate a new product in the PayPal catalog
Create a new product in the PayPal catalog
No parameter schema in public metadata yet.
list_productsList products with optional pagination and filtering
List products with optional pagination and filtering
No parameter schema in public metadata yet.
show_product_detailsRetrieve details of a specific product
Retrieve details of a specific product
No parameter schema in public metadata yet.
update_productUpdate an existing product
Update an existing product
No parameter schema in public metadata yet.
create_subscription_planCreate a new subscription plan
Create a new subscription plan
No parameter schema in public metadata yet.
update_planUpdate an existing plan
Update an existing plan
No parameter schema in public metadata yet.
list_subscription_plansList subscription plans
List subscription plans
No parameter schema in public metadata yet.
show_subscription_plan_detailsRetrieve details of a specific subscription plan
Retrieve details of a specific subscription plan
No parameter schema in public metadata yet.
create_subscriptionCreate a new subscription
Create a new subscription
No parameter schema in public metadata yet.
show_subscription_detailsRetrieve details of a specific subscription
Retrieve details of a specific subscription
No parameter schema in public metadata yet.
update_subscriptionupdate an existing subscription
update an existing subscription
No parameter schema in public metadata yet.
cancel_subscriptionCancel an active subscription
Cancel an active subscription
No parameter schema in public metadata yet.
list_transactionsList transactions with optional pagination and filtering
List transactions with optional pagination and filtering
No parameter schema in public metadata yet.
Sponsors
Configuration
PAYPAL_ACCESS_TOKEN*secretYOUR_PAYPAL_ACCESS_TOKEN ref: https://docs.paypal.ai/developer/how-to/api/get-started
PAYPAL_ENVIRONMENT*'SANDBOX' or 'LIVE'
Readme
PayPal Model Context Protocol
The PayPal Model Context Protocol server allows you to integrate with PayPal APIs through function calling. This protocol supports various tools to interact with different PayPal services.
To run the PayPal MCP server using npx, use the following command:
npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"
Replace YOUR_ACCESS_TOKEN with your PayPal access token. Refer this on how to generate a PayPal access token. Alternatively, you could set the PAYPAL_ACCESS_TOKEN in your environment variables.
Usage with MCP host (Claude Desktop/Cline/Cursor/GitHub Copilot)
This guide explains how to integrate the PayPal connector with Claude Desktop.
Prerequisites
- Claude Desktop application installed
- installing Node.js locally
Installation Steps
1. Install Node.js
Node.js is required for the PayPal connector to function:
- Visit the Node.js official website, download and install it.
- Requirements: Node 18+
Details
- Repository
- github.com/paypal/paypal-mcp-server
- Categories
- Communication & Messaging, Finance & Commerce
- Package
@paypal/mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active