Chargebee MCP Server

MCP server for Chargebee subscription billing and revenue management platform.

Features

  • Customer Management: List, create, and update customers
  • Subscription Lifecycle: List, get, cancel, and reactivate subscriptions
  • Invoicing: Manage invoices, create charges, collect payments
  • Plans & Add-ons: Browse pricing plans and optional add-ons
  • Payment Methods: Manage payment sources (cards, bank accounts)
  • Transactions: View payment history and transaction details
  • Coupons & Credits: Manage discounts and credit notes
  • Events: Audit webhook events and activity logs

Environment Variables

Variable Required Description Example
CHARGEBEE_API_KEY Chargebee API key live_abc123...
CHARGEBEE_SITE Chargebee site name yoursite

Getting Your API Key

  1. Log in to Chargebee
  2. Go to Settings > Configure Chargebee > API Keys & Webhooks
  3. Click Add API Key or copy existing key
  4. Set environment variables:
    export CHARGEBEE_API_KEY="your-api-key"
    export CHARGEBEE_SITE="your-site-name"
    

Required API Scopes

Chargebee API keys have full access to your account. Use appropriate API key types:

  • Full Access Key: All operations
  • Read-Only Key: List/get operations only

Installation

npm install
npm run build

Usage

Stdio Mode

node dist/main.js

With Claude Desktop

{
  "mcpServers": {
    "chargebee": {
      "command": "node",
      "args": ["/path/to/chargebee/dist/main.js"],
      "env": {
        "CHARGEBEE_API_KEY": "your-key",
        "CHARGEBEE_SITE": "your-site"
      }
    }
  }
}

Tools Overview (20+ tools)

Subscriptions (4)

  • chargebee_list_subscriptions - List with pagination
  • chargebee_get_subscription - Get by ID
  • chargebee_cancel_subscription - Cancel subscription
  • chargebee_reactivate_subscription - Reactivate cancelled

Customers (4)

  • chargebee_list_customers - List customers
  • chargebee_get_customer - Get customer
  • chargebee_create_customer - Create new
  • chargebee_update_customer - Update existing

Invoices (4)

  • chargebee_list_invoices - List invoices
  • chargebee_get_invoice - Get invoice
  • chargebee_create_invoice_charge - Add charge
  • chargebee_collect_invoice_payment - Collect payment

Add-ons (2)

  • chargebee_list_addons - List add-ons
  • chargebee_get_addon - Get add-on details

Payment Sources (2)

  • chargebee_list_payment_sources - List payment methods
  • chargebee_create_payment_source - Add payment method

Transactions (2)

  • chargebee_list_transactions - List transactions
  • chargebee_get_transaction - Get transaction

Plans (2)

  • chargebee_list_plans - List pricing plans
  • chargebee_get_plan - Get plan details

Coupons (2)

  • chargebee_list_coupons - List discount coupons
  • chargebee_get_coupon - Get coupon details

Credit Notes (2)

  • chargebee_list_credit_notes - List credit notes
  • chargebee_get_credit_notes - Get credit note

Events (1)

  • chargebee_list_events - List webhook events

Coverage Manifest

Total Chargebee API endpoints: ~150
Tools implemented: 23
Intentionally skipped: 127 (admin endpoints, hosted pages, advanced taxation, dunning management)
Coverage: 23/150 = 15%

Skipped Endpoints

  • Hosted checkout pages (UI-based)
  • Advanced taxation rules
  • Dunning management
  • Quote management
  • Multi-currency pricing
  • Advanced metering

License

MIT