A personal finance management MCP server that integrates with Google Sheets to track transactions, budgets, spending, and financial forecasts.
Finance-mcp has clear verb-based naming (get_, add_, delete_, etc.) and complete JSON schemas with type definitions for all 11 tools. However, descriptions are inconsistent in quality and length. Read-only tools have brief Turkish descriptions (20-60 chars, below the 50-200 char baseline for LLM optimization). Write/destructive tools include security warnings in descriptions, which is good practice but makes them verbose. Parameter descriptions are present but minimal. No output schemas are documented. Error handling is absent, tools return success/failure booleans without guidance on recovery. The confirmation pattern (confirmed flag) for destructive operations is well-intentioned but not enforced at the tool level.
Sheets'e yeni gelir/gider satırı ekler. ÖNEMLİ GÜVENLİK KURALI: Bu aracı çalıştırmadan önce MUTLAKA kullanıcıya eklenecek verinin özetini sun ve 'Onaylıyor musun?' diye sor. Kullanıcı açıkça onay vermeden bu aracı ASLA çağırma. confirmed parametresi kullanıcının açık onayını temsil eder; False ise işlem gerçekleştirilmez.
Bütçe limitlerini gerçek harcamalarla karşılaştırır.
İki farklı ayın finansal durumunu karşılaştırır (Örn: Mart vs Nisan).
Bir kategori için aylık bütçe limiti oluşturur veya günceller. Aynı kategori/ay/yıl kombinasyonu zaten mevcutsa limitini günceller. ÖNEMLİ GÜVENLİK KURALI: Bu aracı çalıştırmadan önce MUTLAKA kullanıcıya kategori, limit ve dönemi göster, 'Onaylıyor musun?' diye sor. Kullanıcı açıkça onay vermeden bu aracı ASLA çağırma. confirmed parametresi kullanıcının açık onayını temsil eder; False ise işlem gerçekleştirilmez.
Belirtilen işlemi Sheets'ten kalıcı olarak siler. ÖNEMLİ GÜVENLİK KURALI: Bu aracı çalıştırmadan önce MUTLAKA kullanıcıya silinecek işlemin özetini sun (tarih, açıklama, tutar) ve 'Onaylıyor musun?' diye sor. Kullanıcı açıkça onay vermeden bu aracı ASLA çağırma. confirmed parametresi kullanıcının açık onayını temsil eder; False ise işlem gerçekleştirilmez.
Read-only tool descriptions are too brief (20-60 chars vs 50-200 baseline). LLMs cannot determine when to select get_monthly_summary vs compare_months without richer context.
No output schemas documented. Tools return success/failure booleans or unstructured data. LLMs cannot plan downstream calls or extract structured results.
Confirmation pattern (confirmed flag) is client-side only. Tools do not validate confirmed=true before executing destructive operations. A malicious or buggy agent can bypass the confirmation by passing confirmed=false and retrying.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
Mevcut bir işlemin alanlarını günceller. Sadece belirtilen new_* alanları değişir. İşlem; date_str, description ve amount üçlüsüyle benzersiz olarak tanımlanır. ÖNEMLİ GÜVENLİK KURALI: Bu aracı çalıştırmadan önce MUTLAKA kullanıcıya mevcut ve yeni değerleri yan yana göster, 'Onaylıyor musun?' diye sor. Kullanıcı açıkça onay vermeden bu aracı ASLA çağırma. confirmed parametresi kullanıcının açık onayını temsil eder; False ise işlem gerçekleştirilmez.
Ayın tüm finansal verilerini toplayıp yerel bir Markdown (.md) dosyası olarak kaydeder.
Belirtilen ay için gelir/gider özeti döndürür.
Son N ay verisiyle gelecek ay tasarruf tahmini üretir.
Belirtilen ay için kategori bazlı harcama dağılımını döndürür.
Google Sheets'e belirtilen ay için yeni bir tasarruf/birikim hedefi yazar.
No error handling or recovery guidance. Tools return boolean success/failure without context. If add_transaction fails, the LLM has no guidance on why or what to do next.
Google Sheets credentials (SERVICE_ACCOUNT_JSON, GOOGLE_SHEETS_ID) are environment variables, which is correct. However, no audit logging of who called what tool or when. Destructive operations (delete_transaction) lack compliance trails.