greek-email-processor

What this skill does

# Greek Email Processor

This skill transforms OpenClaw into an intelligent Greek business email processor that automatically detects, categorizes, and processes financial documents and official communications from Greek government agencies, banks, and business partners.

## Setup

```bash
# 1. Set data directory
export OPENCLAW_DATA_DIR="/data"

# 2. Configure email access (use a scoped service account with read-only access)
export IMAP_HOST="imap.your-provider.com" # e.g. imap.gmail.com, imap.outlook.com
export IMAP_USER="[email protected]"
export IMAP_PASSWORD="app-specific-password"  # Use app passwords, not main password

# 3. Configure outbound email (optional — only needed for auto-responses)
export SMTP_HOST="smtp.your-provider.com" # e.g. smtp.gmail.com, smtp.outlook.com
export SMTP_USER="[email protected]"
export SMTP_PASSWORD="app-specific-password"

# 4. Ensure dependencies are installed
which jq curl || sudo apt install jq curl

# 5. Create incoming directories
mkdir -p $OPENCLAW_DATA_DIR/incoming/{invoices,receipts,statements,government}
```

**Security notes:**
- Use app-specific passwords or app-specific passwords — never your main email password
- Grant the service account the minimum required permissions (read-only for IMAP)
- SMTP credentials are optional — only needed if you enable auto-response features
- All auto-responses require human approval before sending

## Core Philosophy

- **Greek Language First**: Native support for Greek language emails and documents
- **Intelligent Classification**: Automatic detection of document types and priority levels
- **Compliance Focused**: Special handling for AADE, EFKA, and government communications
- **Business Context Aware**: Understanding of Greek business communication patterns
- **Privacy Conscious**: Secure handling of sensitive financial information in emails

## Key Capabilities

### 1. Greek Document Recognition & Classification
- **Invoice Detection**: Identify Greek invoices (ΤΙΜθ΀ºθΓΙθ, ΑΠθΔΕΙξΗ) in email attachments
- **Government Notifications**: Recognize AADE, EFKA, and municipal communications
- **Bank Statements**: Process statements from all major Greek banks
- **Tax Documents**: Detect tax-related emails and forms
- **Client Communications**: Categorize business correspondence and payment requests
- **Receipt Processing**: Identify expense receipts and business documentation

### 2. Email Provider Integration
- **Gmail / Google Workspace**: Via IMAP (use app-specific password) or optional Gmail API (set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET)
- **Outlook / Exchange**: Via IMAP or optional Microsoft Graph API (set MS_CLIENT_ID, MS_CLIENT_SECRET)
- **Any IMAP Provider**: Standard IMAP connection to any email provider
- **IMAP/SMTP Providers**: Any IMAP-compatible business email
- **Yahoo Business**: Yahoo business email support
- **Custom IMAP/POP3**: Support for Greek business email providers
- **Multi-Account Support**: Handle multiple email accounts simultaneously
- **Real-time Monitoring**: Continuous inbox monitoring with configurable intervals

### 3. Greek Language Processing
- **Greek Text Recognition**: Native Greek language email content analysis
- **Mixed Language Support**: Handle Greek-English business communications
- **Greek Date Formats**: Recognize Greek date patterns (dd/MM/yyyy)
- **Currency Detection**: Greek Euro formatting (‚¬1.234,56)
- **Address Parsing**: Greek address format recognition
- **VAT Number Detection**: Identify Greek VAT numbers (EL123456789) in emails

### 4. Automated Processing Workflows
- **Document Extraction**: Automatic attachment download and processing
- **Smart Forwarding**: Route emails to appropriate processing pipelines
- **Client Notification**: Automated responses in Greek for document receipt
- **Priority Escalation**: Flag urgent emails (overdue payments, government notices)
- **Calendar Integration** (optional): Create calendar events for payment due dates if GOOGLE_CALENDAR_ID is configured
- **Task Creation**: Generate accounting tasks from email content

## Implementation Guidelines

### Email Monitoring Architecture

#### IMAP Email Integration
```yaml
IMAP_Configuration:
  imap_permissions:
    protocol: "IMAP for reading, SMTP for sending"
    security: "TLS/SSL required"
  
  monitoring_labels:
    - "INBOX"
    - "UNREAD"
    - "IMPORTANT"
    - custom_labels: ["Accounting", "Tax", "Invoices"]
  
  search_queries:
    invoices: "subject:(πžιμολςγιο OR invoice OR αποδειξη OR receipt)"
    tax_documents: "from:aade.gr OR from:efka.gov.gr OR subject:π πα"
    bank_statements: "from:alphabank.gr OR from:nbg.gr OR from:eurobank.gr OR from:piraeusbank.gr"
    client_payments: "subject:(πληρπ°μή OR payment OR οπ ειλή OR due)"
```

#### IMAP/SMTP Providers Integration
```yaml
Alternative_Provider_Notes:
  microsoft_graph_scopes:
    - "https://graph.microsoft.com/Mail.Read"
    - "https://graph.microsoft.com/Mail.Send"
    - "https://graph.microsoft.com/Mail.ReadWrite"
  
  folder_monitoring:
    - "Inbox"
    - "Accounting"
    - "Tax Documents" 
    - "Bank Statements"
  
  advanced_queries:
    greek_invoices: "subject:πžιμολςγιο OR attachmentNames:invoice"
    government_mail: "from:gov.gr OR from:aade.gr"
    banking: "from:bank OR from:πžράπεζα"
```

### Document Classification Engine

#### Greek Document Types
```yaml
Document_Classification:
  invoices:
    greek_keywords: ["πžιμολςγιο", "αποδειξη", "παρασπžαπžικς", "invoice"]
    file_patterns: ["*.pdf", "*.xml", "*.doc*"]
    confidence_thresholds:
      high: 0.95  # Clear invoice format
      medium: 0.80  # Probable invoice
      low: 0.60   # Possible invoice
    
  tax_documents:
    aade_keywords: ["π πα", "π ςροπš", "δήλπ°ση", "εκκαθαρισπžικς"]
    sender_patterns: ["*@aade.gr", "*@taxisnet.gr"]
    subject_patterns: ["*ΦΠΑ*", "*TAX*", "*ENFIA*"]
    
  bank_statements:
    greek_banks: ["Alpha Bank", "Εθνική Τράπεζα", "Eurobank", "Τράπεζα ΠειραιϽπš"]
    keywords: ["κίνηση λογαριασμού", "statement", "ανπžίγραπ ο", "υπςλοιπο"]
    formats: ["pdf", "csv", "xls", "xlsx"]
    
  receipts:
    keywords: ["αποδειξη", "παρασπžαπžικς", "πžιμολςγιο λιανικήπš", "receipt"]
    amount_patterns: ["‚¬\\d+[.,]\\d+", "\\d+[.,]\\d+\\s*‚¬", "\\d+[.,]\\d+\\s*EUR"]
    vat_patterns: ["ΦΠΑ \\d+%", "VAT \\d+%"]
    
  client_communications:
    payment_keywords: ["πληρπ°μή", "οπ ειλή", "λογαριασμςπš", "πžιμολςγηση"]
    request_keywords: ["παρακαλϽ", "αίπžημα", "π¡ρειάζομαι", "σπžείλπžε"]
    urgent_keywords: ["επείγον", "urgent", "άμεσα", "προθεσμία"]
```

#### Intelligent Content Analysis
```yaml
Content_Analysis_Rules:
  priority_detection:
    high_priority:
      - government_communications: "Emails from AADE, EFKA, municipalities"
      - payment_due: "Overdue payment notices"
      - audit_requests: "Tax audit or compliance requests"
      - system_outages: "TAXIS, myDATA system announcements"
      
    medium_priority:
      - new_invoices: "Incoming invoices from suppliers"
      - bank_notifications: "Bank statement availability"
      - client_requests: "Client document requests"
      - deadline_reminders: "Tax or compliance deadline notices"
      
    low_priority:
      - newsletters: "Professional service newsletters"
      - marketing: "Software or service promotions"
      - routine_confirmations: "Standard transaction confirmations"
  
  automated_actions:
    high_priority_actions:
      - immediate_notification: "notification to assigned accountant"
      - create_calendar_event: "Add deadline to calendar"
      - create_task: "Generate action item in task management"
      - escalate_to_human: "Flag for immediate attention"
      
    medium_priority_actions:
      - extract_attachments: "Download and process documents"
      - forward_to_processing: "Send to document processing pipeline"
      - send_confirmation: "Automated receipt confirmation in Greek"
      - update_client_records: "Log communication in client file"
      
    l