# paypal-mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/paypal/paypal-mcp-server  
**GitHub Stars:** 13  
**npm Downloads (last month):** 2685  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/paypal-mcp-server

## Description
A command line tool for setting up PayPal MCP server

## Tools
Capabilities this server exposes over MCP:

- **create_invoice** — Create a new invoice in the PayPal system
- **list_invoices** — List invoices with optional pagination and filtering
- **get_invoice** — Retrieve details of a specific invoice
- **send_invoice** — Send an invoice to recipients
- **send_invoice_reminder** — Send a reminder for an existing invoice
- **cancel_sent_invoice** — Cancel a sent invoice
- **generate_invoice_qr_code** — Generate a QR code for an invoice
- **create_order** — Create an order in PayPal system based on provided details
- **get_order** — Retrieve the details of an order
- **pay_order** — Process payment for an authorized order
- **create_refund** — Process a refund for a captured payment.
- **get_refund** — Get the details for a specific refund.
- **list_disputes** — Retrieve a summary of all open disputes
- **get_dispute** — Retrieve detailed information of a specific dispute
- **accept_dispute_claim** — Accept a dispute claim
- **create_shipment_tracking** — Create a shipment tracking record
- **get_shipment_tracking** — Retrieve shipment tracking information
- **create_product** — Create a new product in the PayPal catalog
- **list_products** — List products with optional pagination and filtering
- **show_product_details** — Retrieve details of a specific product
- **update_product** — Update an existing product
- **create_subscription_plan** — Create a new subscription plan
- **update_plan** — Update an existing plan
- **list_subscription_plans** — List subscription plans
- **show_subscription_plan_details** — Retrieve details of a specific subscription plan
- **create_subscription** — Create a new subscription
- **show_subscription_details** — Retrieve details of a specific subscription
- **update_subscription** — update an existing subscription
- **cancel_subscription** — Cancel an active subscription
- **list_transactions** — List transactions with optional pagination and filtering

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "paypal-mcp-server": {
    "command": "npx",
    "args": ["-y","@paypal/mcp"],
    "env": {
      "PAYPAL_ACCESS_TOKEN": "",
      "PAYPAL_ENVIRONMENT": ""
    }
  }
}
```

**Requires environment variables:** `PAYPAL_ACCESS_TOKEN`, `PAYPAL_ENVIRONMENT` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What paypal-mcp-server does

The paypal-mcp-server MCP server connects an MCP host to PayPal APIs through the `@paypal/mcp` package. Its tools cover operational tasks across several PayPal areas rather than only payment capture. Agents can create, inspect, send, remind on, cancel, and generate QR codes for invoices. They can also create and retrieve orders, pay authorized orders, issue refunds, and inspect refund details.

Dispute tools list open disputes, retrieve an individual dispute, and accept a dispute claim. Shipment tools create and retrieve tracking records. Catalog tools manage products, while subscription tools handle plans and subscriptions, including updates and cancellation. A transaction-listing tool provides filtered or paginated transaction results.

## How it works

The paypal-mcp-server MCP server is launched as a command-line process with npx and communicates with an MCP host such as Claude Desktop, Cursor, or Cline. The host configuration starts `npx -y @paypal/mcp --tools=all`; credentials are supplied through environment variables or, for the access token, through the command-line configuration described in the project documentation.

Each exposed function maps to a PayPal operation. Listing functions can accept pagination and filtering where supported. Actions that change PayPal data include creating invoices, sending invoices, paying orders, creating refunds, accepting dispute claims, updating products or plans, and cancelling invoices or subscriptions.

## Setup and configuration

Install Node.js 18 or newer, then provide a PayPal access token. The documented environment variables are `PAYPAL_ACCESS_TOKEN` and `PAYPAL_ENVIRONMENT`. Set the environment value to `SANDBOX` for testing or `PRODUCTION` for live use; sandbox is the default when no environment value is supplied.

A minimal MCP host entry uses the following structure:

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

Generate the token from PayPal credentials using a PayPal Developer account for sandbox access or a PayPal Business account for production access. PayPal access tokens expire, so deployments should account for token renewal. Restart the MCP host after changing its configuration.

## Tools and capabilities

The paypal-mcp-server MCP server provides the following capability groups:

- Invoices: create, list, retrieve, send, remind, cancel, and generate QR codes.
- Payments: create and retrieve orders, pay authorized orders, and create or retrieve refunds.
- Disputes: list open disputes, inspect a dispute, and accept a claim.
- Shipment tracking: create and retrieve tracking records.
- Catalog: create, list, inspect, and update products.
- Subscriptions: create, list, inspect, update, and cancel plans or subscriptions.
- Reporting: list transactions with optional pagination and filtering.

Tool access is enabled with `--tools=all` in the documented launch command.

## Limitations and notes

The server requires a valid PayPal access token and the correct environment selection. Sandbox and production use different PayPal contexts, and actions performed in production can affect real PayPal data. The documentation states that generated AI content may be inaccurate or incomplete; results should therefore be independently verified before relying on them.

_Full upstream README: https://allmcps.com/mcp/paypal-mcp-server/readme_