home / mcp / paypal mcp server

PayPal MCP Server

A Python MCP server providing PayPal API endpoints for LLMs to call: invoices, orders, products, subscriptions, shipments, disputes, and transactions.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "akramiot-paypal_mcp_server": {
      "command": "paypal-mcp",
      "args": [
        "--tools=all"
      ],
      "env": {
        "PAYPAL_ENVIRONMENT": "SANDBOX",
        "PAYPAL_ACCESS_TOKEN": "YOUR_PAYPAL_ACCESS_TOKEN"
      }
    }
  }
}

You run a Python MCP server to let Large Language Models interact with PayPal APIs through function calls. This makes it easy to create, view, and manage PayPal resources from your LLM workflows by exposing PayPal endpoints as MCP tools your model can call.

How to use

To use this PayPal MCP server with an MCP client, start the server in stdio mode and enable the full tool set. You will provide your PayPal access token and environment, then instruct your MCP client to load all tools so your model can create, list, view, and manage PayPal resources.

How to install

Prerequisites you need on your system:

Python 3.8+ and pip for installing Python packages.

Install from PyPI

pip install paypal-mcp-server

Install from Source

Clone the repository, install dependencies, and install your package in editable mode.

git clone https://github.com/yourusername/paypal-mcp-server.git
cd paypal-mcp-server
pip install -e .

Using Docker

Pull the latest PayPal MCP Server image from the container registry.

docker pull ghcr.io/yourusername/paypal-mcp-server:latest

Run the server with all tools enabled

Start the server in stdio mode and enable all tools. Provide your PayPal access token and environment via environment variables.

paypal-mcp --tools=all

Run with environment variables

Set your PayPal credentials and environment, then start the server.

export PAYPAL_ACCESS_TOKEN="your_access_token"
export PAYPAL_ENVIRONMENT="SANDBOX"  # or "PRODUCTION"
paypal-mcp --tools=all

Run with docker

Run the container with your credentials and enable all tools.

docker run -e PAYPAL_ACCESS_TOKEN="your_access_token" -e PAYPAL_ENVIRONMENT="SANDBOX" ghcr.io/yourusername/paypal-mcp-server:latest --tools=all

Integration with Claude Desktop

If you use Claude Desktop, add the MCP server configuration to your Claude desktop config so it can call PayPal tools directly.

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

Available tools

invoices.create

Create a new invoice in PayPal.

invoices.list

List existing invoices.

invoices.view

View a specific invoice.

invoices.send

Send an invoice to a recipient.

invoices.remind

Send a payment reminder for an invoice.

invoices.cancel

Cancel an invoice.

invoices.qr

Generate a QR code for an invoice.

orders.create

Create a new PayPal order.

orders.get

Retrieve details of an existing order.

orders.capture

Capture funds for an order.

products.create

Create a new product.

products.list

List products.

products.view

View a product detail.

products.update

Update product information.

subscription_plans.create

Create a new subscription plan.

subscription_plans.list

List subscription plans.

subscription_plans.view

View a subscription plan.

subscriptions.create

Create a new subscription.

subscriptions.view

View a subscription.

subscriptions.cancel

Cancel a subscription.

shipments.create

Create a shipment.

shipments.track

Track a shipment.

disputes.list

List disputes.

disputes.view

View a dispute.

disputes.accept

Accept a dispute resolution.

transactions.list

List and filter transactions.