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

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

Toolkit	Tools
Gmail	GMAIL_FETCH_EMAILS, GMAIL_GET_ATTACHMENT, GMAIL_SEND_EMAIL
Google Sheets	GOOGLESHEETS_BATCH_UPDATE, GOOGLESHEETS_CREATE_GOOGLE_SHEET1
Google Drive	GOOGLEDRIVE_DOWNLOAD_FILE, GOOGLEDRIVE_UPLOAD_FILE
Outlook	OUTLOOK_SEARCH_MESSAGES, OUTLOOK_GET_ATTACHMENT
Xero	XERO_LIST_INVOICES, XERO_CREATE_INVOICE

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.