Track expenses automatically with Telegram Bot using GPT-4o, OCR and voice recognition
DISCOUNT 20%
Personal Expense Tracker Bot 💰
AI-powered Telegram bot for effortless expense tracking. Send receipts, voice messages, or text - the bot automatically extracts and categorizes your expenses.
✨ Key Features
- 📸 Receipt & Invoice OCR - Send photos of receipts or PDF invoices, AI extracts expense data automatically
- 🎤 Voice Messages - Speak your expenses naturally, audio is transcribed and processed
- 💬 Natural Language - Just type "spent 50 on groceries" or any text format
- 🌍 Multilingual - Processes documents in any language (EN, DE, PT, etc.)
- 📊 Smart Statistics - Get monthly totals, category breakdowns, multi-month comparisons
- 🔒 Private & Secure - Single-user authorization, only you can access your data
- ⚡ Zero Confirmation - Expenses are added instantly, no annoying "confirm?" prompts
🎯 How It Works
Send expense data via Telegram:
- Photo of receipt
- PDF invoice
- Voice message
- Text message
AI processes automatically:
- Extracts amount, date, vendor
- Categorizes expense
- Stores in organized format
Query your expenses:
- "Show my expenses for November"
- "How much did I spend on groceries?"
- "Compare last 3 months"
📋 Expense Categories
Groceries, Transportation, Housing, Utilities, Healthcare, Entertainment, Dining Out, Clothing, Education, Subscriptions, Personal Care, Gifts, Travel, Sports, Other
🔧 Setup Requirements
1. Telegram Bot
Create a Telegram bot via @BotFather and get your API token.
Configure credentials for nodes:
- Input, WelcomeMessage,
- GetAudioFile, GetAttachedFile, GetAttachedPhoto
- ReplyText, NotAuthorizedMessage, DeleteProcessing
2. OpenRouter API
Get API key from OpenRouter for AI processing.
Configure credentials for:
- Gpt4o (main processing)
- Sonnet45 (expense assistant)
3. Ainoflow API
Get API key from Ainoflow for storage and OCR.
Configure Bearer credentials for:
- GetConfig, SaveConfig
- ExtractFileText, ExtractImageText
- TranscribeRecording
- JsonStorageMcp (MCP tool)
🏗️ Workflow Architecture
| Section | Description |
|---|---|
| Message Trigger | Receives all Telegram messages |
| Bot Privacy | Locks bot to first user, rejects unauthorized access |
| Chat Message / Audio | Routes text and voice messages to AI |
| Document / Photo | Extracts text from files via OCR and forwards to AI |
| Root Agent | Routes messages to Expense Assistant, validates responses |
| Expense Assistant | Core logic: stores expenses, calculates statistics |
| Result / Reply | Sends formatted response back to Telegram |
| Cleanup / Reset | Manual trigger to delete all data (⚠️ use with caution) |
💬 Usage Examples
Adding Expenses
📸 [Send receipt photo]
→ Added: 45.50 EUR - Groceries (Lidl)
🎤 "Bought coffee for five euros"
→ Added: 5.00 EUR - Dining Out (coffee)
💬 "50 uber"
→ Added: 50.00 EUR - Transportation (uber)
Querying Expenses
"Show my expenses"
→ November 2025: 1,250.50 EUR (23 expenses)
Top: Groceries 450€, Transportation 280€, Dining 220€
"How much on entertainment this month?"
→ Entertainment: 85.00 EUR (3 expenses)
"Compare October and November"
→ Oct: 980€ | Nov: 1,250€ (+27%)
📦 Data Storage
Expenses are stored in JSON format organized by month (YYYY-MM):
{
"id": "uuid",
"amount": 45.50,
"currency": "EUR",
"category": "Groceries",
"description": "Store name",
"date": "2025-11-10T14:30:00Z",
"created_at": "2025-11-10T14:35:22Z"
}
⚠️ Important Notes
- First user locks the bot - Run
/startto claim ownership - Default currency is EUR - AI auto-detects other currencies
- Cleanup deletes ALL data - Use manual trigger with caution
- No confirmation for adding - Only delete operations ask for confirmation
🛠️ Customization
- Change default currency in agent prompts
- Add/modify expense categories in ExpenseAssistant
- Extend Root Agent with additional assistants
- Adjust AI models (swap GPT-4o/Sonnet as needed)
📚 Related Resources
💼 Need Customization?
Want to adapt this template for your specific needs? Custom integrations, additional features, or enterprise deployment?
Contact us at Ainova Systems - We build AI automation solutions for businesses.
Tags: telegram, expense-tracker, ai-agent, ocr, voice-to-text, openrouter, mcp-tools, personal-finance