Connector · Payments · 6 min read

Connect PayPal to Claude

PayPal is one of the first payment processors to ship a Model Context Protocol (MCP) server for Claude. Once it’s connected, you can create invoices, pull transaction reports, and draft dispute responses by typing what you want in plain English - Claude does the API work behind the scenes.

1What it unlocks

Three things you couldn’t do from chat before

1 · Invoice
Conversational invoicing
Describe an invoice in a sentence; Claude creates it via the PayPal API and sends it for your approval.
2 · Report
Live transaction context
“What did I make in May? Top 5 customers?” pulled in real time - no manual CSV exports.
3 · Disputes
Faster, kinder responses
Claude reads the dispute detail and drafts a measured response you can edit and send.

2The fast install (one click)

PayPal is listed in Anthropic’s MCP directory. For most small businesses this is all you need - no terminal, no config files.

New to PayPal? Open a free PayPal business account first - takes a few minutes, then come back here to wire it into Claude.

The web walkthrough:
  1. Open Claude and go to Customise → Connectors (or claude.ai/directory).
  2. Search for PayPal.
  3. Click Connect. You’ll be sent to PayPal to sign in and grant access.
  4. Approve the requested scopes (invoicing, transaction read, disputes - review the list before clicking accept).
  5. You’re back in Claude with PayPal showing as Connected. Try the first prompts below.

Official PayPal walkthrough: developer.paypal.com.

3Sandbox vs. Production

PayPal lets you connect either your sandbox (a fake-money play environment) or your production account. Use sandbox first to feel the connector out without risking real money.

ModeWhen to use itNotes
Sandbox Your first hour with the connector. Trial invoices, fake disputes, smoke-test prompts. Sign up at developer.paypal.com to get sandbox accounts. Nothing you do here touches real money.
Production Once you trust the workflow. CarefulInvoices Claude creates here go to real customers. Always review before sending.

4First prompts to try

Pick one that matches the chore that annoys you most this week.

Create a draft PayPal invoice for $1,250 to anna@example.com for “Logo and brand guide - final”, due in 14 days. Show me the draft before sending.

Summarise last month’s PayPal transactions. Top 5 customers by total, average transaction size, and any refunds I should look at.

List all open PayPal disputes. For each, give me a short summary, the customer’s argument, and a suggested response in our friendly-but-firm tone.

Build a CSV-style table of all PayPal sales tagged “coaching” in Q1, with date, amount, and customer email.

5Optional: local MCP setup

If you’d rather run the PayPal MCP server locally (e.g. for development, or to keep your token off the web), Claude Desktop supports that too. Edit your config file: 

// ~/Claude/claude_desktop_config.json  (Windows: %APPDATA%\Claude\claude_desktop_config.json)
{
  "mcpServers": {
    "paypal": {
      "command": "npx",
      "args": ["-y", "@paypal/agent-toolkit"],
      "env": {
        "PAYPAL_ACCESS_TOKEN": "YOUR_TOKEN_HERE",
        "PAYPAL_ENVIRONMENT": "SANDBOX"
      }
    }
  }
}

Restart Claude Desktop after editing. The remote (one-click web) version is what most small businesses should use - reach for the local config only if you have a specific reason.

6Safety & what to expect

ConcernWhat actually happens
Will Claude move money without me asking?No. Money-moving actions require an explicit confirmation step. Claude shows you the action first and waits for your “go.”
Does PayPal see my chats?PayPal only sees the API calls Claude makes (e.g. “create invoice with these fields”) - not the surrounding conversation.
What if I revoke access?Open paypal.com → Account Settings → Apps & Permissions and revoke the Claude connection. It disconnects immediately.
What if I want to limit scope?The OAuth screen shows every scope Claude is asking for. You can decline scopes you don’t want (e.g. write access) and still use the read parts.
Next step: if invoicing is now flowing, pair PayPal with QuickBooks so the numbers Claude pulls match the ones your accountant sees - or with HubSpot so a closed deal can mint an invoice in the same chat.