> ## Documentation Index
> Fetch the complete documentation index at: https://help.privy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Privy MCP

> Connect AI assistants like ChatGPT and Claude to your Privy account with the Privy MCP server.

The Privy MCP server lets AI assistants read what your Privy account has set up — campaigns, contacts, coupons, displays, flows, orders, segments, and store products — so you can ask questions like "How did my welcome flow do last month?" or "Which of my popups converts best?" directly in ChatGPT, Claude, or any [MCP](https://modelcontextprotocol.io/)-compatible assistant.

All tools are **read-only**. Assistants can look at your data; they can't change anything in your account.

## Requirements

* A **paid Privy plan**.
* An AI assistant that supports remote MCP servers with OAuth.

You don't need to create an API token or OAuth application. When your assistant first connects, it opens a browser window where you log in to Privy and pick a business — the same login you use for the [Privy dashboard](https://dashboard.privy.com).

## What your assistant can read

| Area      | What's available                                           |
| --------- | ---------------------------------------------------------- |
| Account   | Business details, subaccounts, onboarding and setup status |
| Campaigns | Email and SMS campaigns with performance stats             |
| Contacts  | Search and read contacts and their consent status          |
| Coupons   | Coupon codes and how they're being used                    |
| Displays  | Popups, flyouts, banners, and embedded forms               |
| Flows     | Automation flows with triggers, filters, and steps         |
| Orders    | Orders across every source, with date filters              |
| Products  | Your connected store's product catalog                     |
| Segments  | Segment definitions, sizes, and members                    |

## Server URL

```text theme={null}
https://mcp.privy.com/mcp/
```

## ChatGPT

On individual ChatGPT plans that support custom connectors, add the server URL above yourself under **Settings → Connectors** with developer mode enabled.

### ChatGPT workspaces

For teams, Privy connects to ChatGPT as a **workspace connector**, managed by your ChatGPT workspace admin.

<Steps>
  <Step title="Admin: add the connector">
    A workspace admin (ChatGPT Business, Enterprise, or Edu) goes to **Settings → Connectors**, creates a custom connector named **Privy** with the MCP server URL above, selects **OAuth** authentication, and publishes it to the workspace.
  </Step>

  <Step title="Connect your Privy account">
    Each user connects individually: open **Settings → Connectors**, find **Privy**, and click **Connect**. ChatGPT opens a browser window — log in to Privy and select your business.
  </Step>

  <Step title="Use it in a chat">
    Enable the Privy connector from the tools menu in the composer, then ask ChatGPT about your account — for example, "What's my list growth this quarter, email vs SMS?"
  </Step>
</Steps>

## Claude

On individual Claude plans, add the connector yourself: go to **Settings → Connectors**, click **Add custom connector**, and enter the server URL above.

### Claude organizations

On Claude Team and Enterprise plans, Privy connects to Claude's web and desktop apps as an **organization connector**, managed by a Claude admin.

<Steps>
  <Step title="Admin: add the connector">
    A Claude admin goes to **Admin settings → Connectors**, adds a connector named **Privy** with the MCP server URL above, and enables it for the organization.
  </Step>

  <Step title="Connect your Privy account">
    In a chat, open the tools menu, find **Privy**, and click **Connect**. Claude opens a browser window — log in to Privy and select your business.
  </Step>

  <Step title="Use it in a chat">
    With the Privy connector enabled, ask Claude about your account — for example, "How did my abandoned cart flow perform last month?"
  </Step>
</Steps>

### Claude Code

Add the server from your terminal:

```bash theme={null}
claude mcp add --transport http privy https://mcp.privy.com/mcp/
```

The first time Claude Code uses a Privy tool, it opens a browser window to log in and select your business.

## Gemini CLI

Add the server from your terminal:

```bash theme={null}
gemini mcp add --transport http privy https://mcp.privy.com/mcp/
```

Gemini CLI discovers the OAuth requirement automatically and opens a browser window to log in and select your business. If you aren't prompted, run `/mcp auth privy` inside the CLI to start the login.

## Cursor

Add Privy to `~/.cursor/mcp.json` (or a project's `.cursor/mcp.json`):

```json theme={null}
{
  "mcpServers": {
    "privy": {
      "url": "https://mcp.privy.com/mcp/"
    }
  }
}
```

Cursor prompts you to authenticate with Privy the first time the server is used.

## Other MCP clients

Any client that supports remote MCP servers with OAuth works with this standard configuration:

```json theme={null}
{
  "mcpServers": {
    "privy": {
      "type": "http",
      "url": "https://mcp.privy.com/mcp/"
    }
  }
}
```

## Disconnecting

Remove the Privy server from your assistant's MCP or connector settings. That ends the assistant's access; reconnecting requires logging in to Privy again.

## Troubleshooting

* **Login succeeds but the connection fails** — make sure your account is on a paid Privy plan. If it is and connecting still fails, contact [Support](mailto:support@privy.com).
* **No business appears during login** — only businesses on a paid plan are shown in the business picker.
* **Requests start failing after working fine** — disconnect and reconnect the server in your assistant to start a fresh session.