# mcp-chargebee

Manages recurring subscriptions, customer records, and invoices in Chargebee through your AI agent. Useful for automating SaaS billing tasks directly from the workspace.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/chargebee
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-chargebee

## What it does

The server connects language models to Chargebee v2 billing endpoints using 15 dedicated tools. Your assistant can create, retrieve, modify, pause, or reactivate subscriptions, inspect invoices, and read webhook event logs. Outgoing requests use `application/x-www-form-urlencoded` formatting. The server flattens nested JSON payloads into bracket notation on the fly.

List queries support structured filters matching the `field[operator]=value` convention via the `filters` parameter or direct top-level options. You can also attach gateway payment tokens to existing customers or delete stored payment sources when cards expire.

Calls fail immediately without valid `CHARGEBEE_SITE` and `CHARGEBEE_API_KEY` credentials. When setting up automated workflows, start with your sandboxed test site (`<site>-test`) to prevent unintended modifications to live accounts.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CHARGEBEE_SITE`, `CHARGEBEE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-chargebee -e CHARGEBEE_SITE=<CHARGEBEE_SITE> -e CHARGEBEE_API_KEY=<CHARGEBEE_API_KEY> -- npx -y @codespar/mcp-chargebee
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add chargebee --env CHARGEBEE_SITE=<CHARGEBEE_SITE> --env CHARGEBEE_API_KEY=<CHARGEBEE_API_KEY> -- npx -y @codespar/mcp-chargebee
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "chargebee": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-chargebee"
            ],
            "env": {
                "CHARGEBEE_SITE": "<CHARGEBEE_SITE>",
                "CHARGEBEE_API_KEY": "<CHARGEBEE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "chargebee": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-chargebee"
            ],
            "env": {
                "CHARGEBEE_SITE": "<CHARGEBEE_SITE>",
                "CHARGEBEE_API_KEY": "<CHARGEBEE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CHARGEBEE_SITE=<CHARGEBEE_SITE> -e CHARGEBEE_API_KEY=<CHARGEBEE_API_KEY> chargebee npx -y @codespar/mcp-chargebee
```
Replace <…> with your own values

## When to use it
- manage recurring customer subscriptions and renewal statuses
- inspect unpaid invoices and track incoming webhook events
- attach external gateway tokens to customer payment profiles
- filter active subscriptions by plan identifier

## Example prompts
- Find all active subscriptions on the pro-monthly plan
- Cancel subscription sub_98765 and show the confirmation
- Retrieve the latest invoices for customer cust_12345

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md