actual-mcp-server
Actual MCP Server es un servidor HTTP y stdio que conecta cualquier cliente MCP (como LibreChat, LobeChat o Claude Desktop) a una instancia de Actual Budget. Permite consultar transacciones, presupuestos y reglas sin abrir la interfaz del programa.
Ficha actualizada 23 sept 2026, 4:01 · upstream 23 sept 2026, 3:54 · release v0.22.4
Qué es actual-mcp-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
El proyecto proporciona acceso completo a las herramientas de gestión financiera de Actual Budget a través de protocolos de contexto de modelo (MCP). Consta de 81 herramientas que cubren operaciones bancarias, transferencias, categorías, pagadores, etiquetas, notas y reglas. Funciona tanto como un servidor HTTP remoto para clientes externos como como proceso stdio local para Claude Desktop.
- Consultar transacciones recientes por categoría o monto
- Crear nuevas transacciones desde el chat del cliente
- Analizar gastos mensuales con consultas SQL nativas de Actual Budget
- Gestionar presupuestos y alertas de gasto
- Exportar datos financieros a formatos externos
- Automatizar reportes mensuales mediante reglas programadas
- 81 herramientas que cubren el API completo de Actual Budget sin brechas conocidas
- Soporte tanto en transporte HTTP como stdio, eliminando la necesidad de Docker para uso local
- 6 herramientas exclusivas con motor de consultas SQL de Actual Budget
- Multi-budget switching mediante actual_budgets_switch que permite cambiar entre presupuestos activos
- Autenticación segura con JWT basados en JWKS y ACLs por usuario
- Procesamiento asíncrono con retry exponencial y backoff para evitar bloqueos
- El servidor no puede acceder a datos de Actual Budget que no estén sincronizados (requiere volumen local /app/data)
- La sincronización bancaria depende del estado actual del cliente de Actual Budget
- Las herramientas stdio requieren un entorno con acceso a terminal y variables de entorno configurables
- El uso en entornos multi-usuario requiere configuración adicional de tokens JWT por usuario
- Actualidad: la versión 1.0.4 no incluye soporte para transacciones de tarjetas de crédito
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalación recomendada vía Docker con volumen persistente /app/data para almacenar datos locales del cliente. Para producción, se recomienda HTTPS con certificados auto-generados o un reverse proxy (Nginx) como actual-mcp-server:3600 -> https://actual.yourdomain.com. El token de autorización MCP debe ser secreto y no exponer en logs. En modo stdio, asegúrese de configurar MCP_BRIDGE_DATA_DIR como ruta absoluta para evitar errores de resolución de directorios.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.