Billing Invoice Automation
A CLI tool that sets up a Composio MCP server and generates MCP URLs for IDEs like VSCode and Claude Desktop to automate billing, invoices, expenses, travel bills, and payments via natural language chat.
Ask AI about Billing Invoice Automation
Powered by Claude Β· Grounded in docs
I know everything about Billing Invoice Automation. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
- Verify the URL and API key in your IDE configuration
- Restart your IDE after updating the configuration
- Check that your Composio API key has the necessary permissions
License
This project is under MIT license.
