Servidor MCP de Seguimiento de Gastos

Un servidor MCP (Model Context Protocol) local y ligero que te permite registrar, listar, resumir y eliminar gastos personales directamente a través de Claude, sin aplicaciones, sin introducir datos en hojas de cálculo, solo conversación natural.

Construido con FastMCP y respaldado por una base de datos SQLite local.

Por qué

La mayoría de las aplicaciones de seguimiento de gastos son torpes: demasiados toques, categorías rígidas o muros de pago por suscripción solo para registrar un café. Este servidor convierte a Claude en tu rastreador de gastos: solo le dices en qué gastaste y queda guardado. Pide un resumen en cualquier momento y obtén un desglose instantáneo por categoría.

Related MCP server: Expense Tracker MCP Server

Características

• Añade gastos con fecha, categoría, importe, subcategoría y notas

• Lista gastos dentro de un rango de fechas

• Resume el gasto por categoría (opcionalmente filtrado a una categoría)

• Elimina gastos por ID

• Datos almacenados localmente en un único archivo SQLite: totalmente privado, sin sincronización en la nube

Requisitos

• Python 3.10+

• fastmcp

Instala las dependencias:

pip install fastmcp

Configuración

1. Guarda el script del servidor (por ejemplo, expense_server.py) en algún lugar permanente de tu máquina.

2. En la primera ejecución, crea automáticamente expenses.db en el mismo directorio: no se necesita configuración manual de la base de datos.

3. Añádelo a tu archivo de configuración de Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "expense-tracker": {
         "command": "python",
         "args": ["/full/absolute/path/to/expense_server.py"]
       }
     }
   }

   Usa la ruta absoluta al script. Si estás usando un entorno virtual, apunta command al binario de Python de ese entorno en lugar del python del sistema.

4. Reinicia Claude Desktop. Las cuatro herramientas siguientes deberían aparecer como disponibles.

Herramientas

Las fechas deben estar en formato YYYY-MM-DD.

Ejemplo de uso

Solo habla con Claude de forma natural una vez que el servidor esté conectado:

• "Registra 450 en comestibles hoy, subcategoría verduras"

• "Gasté 1200 en alquiler ayer, nota: alquiler de agosto"

• "Muéstrame todo lo que gasté este mes"

• "¿Cuál es mi desglose por categoría para agosto de 2026?"

• "¿Cuánto gasté en comida entre el 1 y el 15 de agosto?"

• "Elimina el gasto #12, lo introduje dos veces"

Almacenamiento de datos

Todos los datos viven en expenses.db, un archivo SQLite creado junto al script. No se envía nada a ningún otro lugar: esto es completamente local y privado.

Esquema:

expenses
├── id            INTEGER PRIMARY KEY AUTOINCREMENT
├── date          TEXT NOT NULL
├── category      TEXT NOT NULL
├── amount        REAL NOT NULL
├── subcategory   TEXT DEFAULT ''
└── note          TEXT DEFAULT ''

Cómo hacer una copia de seguridad de tus datos

Como todo vive en un solo archivo, haz una copia de seguridad periódicamente:

cp expenses.db "expenses_backup_$(date +%Y%m%d).db"

Considera automatizar esto con un trabajo cron semanal (macOS/Linux) o el Programador de tareas (Windows).

Notas y consejos

• Los nombres de las categorías no están restringidos, así que intenta mantener mayúsculas/ortografía coherentes (por ejemplo, siempre "Comestibles", no una mezcla de "comestibles" / "Comestible") para mantener los resúmenes limpios.

• Pide a Claude que liste tus categorías existentes antes de añadir una nueva si quieres evitar duplicados.

• Este servidor no tiene autenticación ni exposición a la red: solo se ejecuta localmente a través de stdio, por lo que es seguro usarlo sin configuración de seguridad adicional.

Licencia

Uso personal: adáptalo libremente a tu propio flujo de trabajo.