Billing Invoice Automation MCP

A CLI utility that creates and configures a Composio MCP server for billing automation. Generate MCP URLs for your IDE (VSCode, Claude Desktop) to automate invoice generation, expense tracking, travel bill organization, and payment via natural language chat.

Features

• Email Invoice Ingestion: Fetch invoices from Gmail and Outlook via natural language

• Spreadsheet Tracking: Store and organize invoice data in Google Sheets

• Travel Bill Organization: Categorize and track travel expenses

• Invoice Generation: Create and send invoices via email

• Xero Integration: Sync invoice data with Xero accounting

Related MCP server: FacturaHub MCP Server

Prerequisites

• Node.js 18.0.0 or higher

• A Composio account and API key

Quick Start

Step 1: Clone and Install

git clone <repository-url>
cd Billing-Automation
npm install
npm run build

Step 2: Configure Environment

Create a .env file in the root directory:

COMPOSIO_API_KEY=your_api_key_here

Get your API key from the Composio Dashboard.

Step 3: Create MCP Server

node dist/cli.js setup

Save the Server ID from the output (e.g., d923db26-cabf-480b-9fe2-b3445e4988c1).

Step 4: Generate MCP URL

node dist/cli.js generate your@email.com --server-id your_server_id

This outputs your MCP URL and IDE configuration snippets.

Step 5: Configure Your IDE

Copy the generated configuration to your IDE:

VSCode → .vscode/mcp.json

{
  "mcpServers": {
    "billing-agent": {
      "type": "http",
      "url": "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=your@email.com",
      "headers": {
        "x-api-key": "YOUR_COMPOSIO_API_KEY"
      }
    }
  }
}

Claude Desktop → ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "billing-agent": {
      "type": "http",
      "url": "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=your@email.com",
      "headers": {
        "x-api-key": "YOUR_COMPOSIO_API_KEY"
      }
    }
  }
}

Step 6: Restart Your IDE

Restart VSCode or Claude Desktop to load the new MCP configuration.

Example Chat Interactions

Once configured, you can interact with the billing agent via natural language:

Fetch invoices from email:

"Fetch all invoices from my Gmail from November 2025"

Track expenses in a spreadsheet:

"Create a Google Sheet to track my invoices and add the ones you just found"

Organize travel expenses:

"Find all my travel receipts from the last month and categorize them by type"

Generate and send an invoice:

"Create an invoice for $500 for consulting services and send it to client@example.com"

Sync with Xero:

"List my recent invoices from Xero and check if any are overdue"

Authentication

When you first use a tool that requires authentication (e.g., Gmail, Google Sheets), the MCP server will prompt you with an OAuth authorization URL. Click the link to authenticate, and the connection will be saved for future use.

Configured Tools

Troubleshooting

"COMPOSIO_API_KEY environment variable is required"

Make sure you've created a .env file with your API key.

"Invalid Composio API key"

Verify your API key is correct in the Composio Dashboard.

IDE not connecting to MCP server

1. Verify the URL and API key in your IDE configuration

2. Restart your IDE after updating the configuration

3. Check that your Composio API key has the necessary permissions

License

This project is under MIT license.