Connect PayPal to Claude Code

Read transactions, balances and disputes, manage invoices and orders, and issue refunds. Add Toolspoke to Claude Code once and it can use 16 PayPal actions. Your PayPal credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

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

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install PayPal and connect it

    Add PayPal to a project in your Toolspoke workspace.

    REST app client credentials. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    Client ID
    PayPal Developer Dashboard (developer.paypal.com) → Apps & Credentials → switch to Live (or Sandbox) → your REST app, or Create App. The Client ID is shown on the app's page. Turn on Transaction Search under the app's features if list_transactions or get_balances should work.
    Secret key
    On the same app page, under Secret key, click Show. PayPal exchanges it for a short-lived access token; the secret itself never reaches an API endpoint.
  3. Choose what Claude Code may do

    All 16 actions start on. Switch off any of the 6 actions that change something in PayPal, and Claude Code gets a refusal if it tries.

What you can ask Claude Code for

A few of the PayPal actions that only read, so they are safe to try first.

  • Search the account's transactions between two dates, at most 31 days apart
  • List the account's balances in every currency it holds, optionally as of a past date-time
  • List the account's invoices, newest first, with status, recipient and amount
  • Search invoices by recipient email, invoice number or status

What Claude Code can do in PayPal

10 actions read, 2 write and 4 delete or permanently change something.

Reads

  • List transactions

    Search the account's transactions between two dates, at most 31 days apart. Results can lag real time by up to three hours. fields controls how much each row carries: transaction_info returns only the transaction itself; all adds payer, cart and shipping detail. Requires Transaction Search to be enabled on the REST app.

  • Get balances

    List the account's balances in every currency it holds, optionally as of a past date-time. Requires Transaction Search on the REST app.

  • List invoices

    List the account's invoices, newest first, with status, recipient and amount. Takes no required arguments, which is why it is the connection test.

  • Search invoices

    Search invoices by recipient email, invoice number or status.

  • Get invoice

    Retrieve one invoice by id, with its items, recipients, payments and refunds.

  • Get order

    Retrieve one checkout order by id, with its status, payer and any captures.

  • Get capture

    Retrieve one captured payment by id, with its amount, fees and status.

  • Get refund

    Retrieve one refund by id, with its amount and status.

  • List disputes

    List disputes and claims opened against this account, optionally by state.

  • Get dispute

    Retrieve one dispute by id, with the disputed transaction, messages and evidence.

Writes

  • Create draft invoice

    Create a draft invoice to one recipient. A write rather than destructive: a draft is not sent and nobody sees it until send_invoice. Items are [{name, quantity, unit_amount: {currency_code, value}}], with quantity and value as decimal strings.

  • Create order

    Create a checkout order for one amount. A write rather than destructive: no money moves until the payer approves it and capture_order is called. Returns the order id and the approve link to give the payer.

Deletes or permanently changes

  • Send invoice

    Send a draft invoice to its recipient. Destructive because it emails someone outside the workspace a request for money, and a sent invoice cannot be unsent, only cancelled, which notifies them again.

  • Cancel invoice

    Cancel a sent invoice so it can no longer be paid. Destructive because it cannot be reversed and, by default, notifies the recipient.

  • Capture order

    Capture payment for an order the payer has approved. Destructive because it moves the payer's money into this account; undoing it means refund_capture.

  • Refund capture

    Refund a captured payment, in full or in part. Destructive because it sends money back to the payer and cannot be undone. Leave amount out to refund the full capture.

PayPal in Claude Code: questions

Does Claude Code see my PayPal credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop Claude Code from changing things in PayPal?

Yes. Each of the 16 actions can be switched off for a project. Turn off the 6 that change something and Claude Code can only read.

Will 16 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the PayPal action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a PayPal call does not run in a sandbox, so it bills nothing.

Try PayPal in Claude Code

Free to start, and tool calls cost nothing on any plan.