PayPal MCP Server

Official

Invoices, payments and disputes through PayPal's official server — commerce operations by conversation.

Local + remotestdiostreamable-httpTypeScriptMIT★ 200

What is the PayPal MCP Server?

PayPal's official MCP server (hosted at mcp.paypal.com with OAuth, or local via the agent toolkit) brings the operational side of a PayPal business account into conversation: invoicing, payment and refund management, dispute tracking, subscription plans, shipment tracking and transaction reporting.

Invoicing is the flagship flow, and a genuinely good fit for natural language: "invoice Acme Corp $2,400 for March consulting, net-30" carries all the structure an invoice needs, so dictating it beats form-filling. Follow-ups ("send a reminder for every invoice more than two weeks overdue") turn receivables-chasing — the chore every freelancer defers — into a sentence.

The reporting and dispute tools serve the Monday-morning questions: what came in last week, what's pending, which disputes need evidence by when. For small businesses running on PayPal, having these answers conversationally rather than dashboard-deep changes how often they actually get asked.

The trust posture mirrors Stripe's: OAuth on the hosted server, scoped credentials locally, client-side confirmations for anything that moves money or messages customers. Sandbox mode is the right place to learn its behaviour. It's a narrower server than Stripe's (no docs-search half) but for its audience — businesses whose money already flows through PayPal — the invoice-remind-report loop alone justifies the ten-minute setup.

Before you switch to live

  • Create both sandbox personas in the developer dashboard, buyer and seller. Watching a test invoice actually arrive tells you more than watching one get created.
  • Access tokens from PayPal's OAuth endpoint expire in hours, not months. A local setup without a refresh step turns into a weekly ritual of re-pasting PAYPAL_ACCESS_TOKEN.
  • Creating and sending an invoice are deliberately two calls. Create the draft, read it back, then send — a wrong draft costs nothing, a wrong sent invoice costs an apology.
  • State the currency explicitly. Invoices follow the account's supported currency list, and anything cross-currency picks up conversion fees the recipient will notice.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

What you can do with it

Dictated invoicing

Invoices created and sent from a sentence; reminders batched the same way.

Receivables hygiene

Who owes what, and which reminders went out — asked, not assembled.

Dispute triage

Evidence deadlines and dispute states surfaced before they bite.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
create_invoice / send_invoiceCreate and deliver invoices
send_invoice_reminderChase overdue invoices
list_transactionsTransaction history and reports
create_refund / get_refundRefund workflows
list_disputes / get_disputeDispute queues and detail
create_subscription_planSubscription products and plans
get_shipment_trackingOrder shipment status

How to install the PayPal MCP Server

claude mcp add --transport http paypal https://mcp.paypal.com/mcp

Configuration

A PayPal business account. Remote: OAuth. Local: developer credentials — sandbox first.

VariableDescriptionRequired
PAYPAL_ACCESS_TOKENAccess token for local mode (remote uses OAuth)Optional
PAYPAL_ENVIRONMENTSANDBOX or PRODUCTIONe.g. SANDBOXOptional

Example prompts to try

  • “Invoice Acme Corp $2,400 for March consulting, net-30, and send it.”
  • “Send reminders for all invoices overdue by 14+ days.”
  • “Summarise last month's transactions and any open disputes.”

Frequently asked questions

It can create refunds and send invoices, so treat it as money-adjacent: sandbox to learn, confirmations on, production scopes granted deliberately.