paypal-mcp-server — Claude Code MCP server
Connects PayPal APIs to an MCP agent for invoices, orders, refunds, subscriptions, disputes, and transaction queries.
claude mcp add paypal-mcp-server -e PAYPAL_ACCESS_TOKEN=<PAYPAL_ACCESS_TOKEN> -e PAYPAL_ENVIRONMENT=<PAYPAL_ENVIRONMENT> -- npx -y @paypal/mcpWhat paypal-mcp-server does
paypal-mcp-server runs through npx and exposes PayPal API actions to an MCP host. Its tools cover invoice creation, lookup, delivery, reminders, cancellation, and QR generation. They also handle orders, captured-payment refunds, disputes, shipment tracking, and transaction listings.
The server includes tools for PayPal catalog items and subscription plans. It can create and update products, inspect plans, create subscriptions, and cancel active ones. Setup requires Node.js 18+ and PAYPAL_ACCESS_TOKEN; PAYPAL_ENVIRONMENT selects SANDBOX or PRODUCTION. Without an access token, PayPal API calls cannot run.
In Claude Code, add the server with claude mcp add; the command starts the @paypal/mcp package through npx. Use a sandbox token while testing and set the production environment for live PayPal work.
What it helps with
- create and send a PayPal invoice
- filter and inspect invoice records
- place an order or issue a refund
- review open disputes and transactions
- create or cancel a subscription
Example prompts for the agent
- List my PayPal invoices and filter them by status.
- Create a PayPal order from the data in this project.
- Show open disputes and prepare a review list.
How to install paypal-mcp-server
Platform CLI
claude mcp add paypal-mcp-server -e PAYPAL_ACCESS_TOKEN=<PAYPAL_ACCESS_TOKEN> -e PAYPAL_ENVIRONMENT=<PAYPAL_ENVIRONMENT> -- npx -y @paypal/mcpReplace <…> with your own values
Platform CLI
codex mcp add paypal-mcp-server --env PAYPAL_ACCESS_TOKEN=<PAYPAL_ACCESS_TOKEN> --env PAYPAL_ENVIRONMENT=<PAYPAL_ENVIRONMENT> -- npx -y @paypal/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"paypal-mcp-server": {
"command": "npx",
"args": [
"-y",
"@paypal/mcp"
],
"env": {
"PAYPAL_ACCESS_TOKEN": "<PAYPAL_ACCESS_TOKEN>",
"PAYPAL_ENVIRONMENT": "<PAYPAL_ENVIRONMENT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"paypal-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@paypal/mcp"
],
"env": {
"PAYPAL_ACCESS_TOKEN": "<PAYPAL_ACCESS_TOKEN>",
"PAYPAL_ENVIRONMENT": "<PAYPAL_ENVIRONMENT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PAYPAL_ACCESS_TOKEN=<PAYPAL_ACCESS_TOKEN> -e PAYPAL_ENVIRONMENT=<PAYPAL_ENVIRONMENT> paypal-mcp-server npx -y @paypal/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about paypal-mcp-server
How do I install paypal-mcp-server in Claude Code?
Run claude mcp add paypal-mcp-server -e PAYPAL_ACCESS_TOKEN=<PAYPAL_ACCESS_TOKEN> -e PAYPAL_ENVIRONMENT=<PAYPAL_ENVIRONMENT> -- npx -y @paypal/mcp.
What does paypal-mcp-server do?
It connects PayPal APIs to an MCP-compatible agent and exposes tools for invoices, payments, refunds, disputes, catalog items, subscriptions, shipping records, and transactions.
What does paypal-mcp-server require?
You need Node.js 18+ and a PayPal access token in PAYPAL_ACCESS_TOKEN. Set PAYPAL_ENVIRONMENT to SANDBOX for testing or PRODUCTION for live use.
