PayPal

by PayPal

v1.8.1

Repository Docs npm

Payments & Commerce

paymentspaypalinvoicingcommerce

Summary

PayPal's official MCP server — create invoices, manage orders and subscriptions, and query transactions.

Features

Create and manage invoices and payment links
Look up orders, transactions, and disputes
Manage products and subscription plans

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "PayPal" tools will be available.

{
  "mcpServers": {
    "paypal": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/mcp",
        "--tools=all"
      ],
      "env": {
        "PAYPAL_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add paypal -e PAYPAL_ACCESS_TOKEN=your-access-token -- npx -y @paypal/mcp --tools=all

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "paypal": {
      "command": "npx",
      "args": [
        "-y",
        "@paypal/mcp",
        "--tools=all"
      ],
      "env": {
        "PAYPAL_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "@paypal/mcp",
    "--tools=all"
  ],
  "env": {
    "PAYPAL_ACCESS_TOKEN": "your-access-token"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "@paypal/mcp",
    "--tools=all"
  ],
  "env": {
    "PAYPAL_ACCESS_TOKEN": "your-access-token"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "@paypal/mcp",
    "--tools=all"
  ],
  "env": {
    "PAYPAL_ACCESS_TOKEN": "your-access-token"
  }
}

Description

PayPal's official MCP server, part of its agent toolkit, gives an assistant access to PayPal's merchant APIs.

What it covers

Invoicing — create, send, and track invoices, and generate payment links
Orders — create and capture orders, and look up their status
Subscriptions — manage products, billing plans, and subscriber records
Transactions — search and report on payment history
Disputes — list and inspect cases, and respond to them
Shipment tracking attached to transactions

Realistic uses

Generating an invoice from a description of the work, reconciling a period's transactions, investigating why a specific payment failed, and setting up subscription plans without navigating the merchant dashboard.

Security posture

This touches money. Use sandbox credentials while developing, scope the access token to the minimum set of operations, and treat any tool that creates or captures a payment as requiring explicit confirmation rather than autonomous action.

Runs with npx -y @paypal/mcp --tools=all, with tool selection available to narrow what the assistant can reach.

Related MCP Servers

Shopify Dev

by Shopify

Shopify's official developer MCP server — accurate API docs and schema introspection for building Shopify apps.

Payments & Commerce

shopifyecommercegraphql

Square

by Square

Square's official MCP server — manage catalog, orders, payments, customers, and inventory from an AI client.

Payments & Commerce

paymentssquarepos

Browse all MCP servers →