runBqlQuery
Ejecuta consultas BQL (Beancount Query Language) contra saldos, transacciones y cuentas.
Model Context Protocol
Tu libro mayor entra en la conversación.
Conecta Beancount con las herramientas de IA que ya usas. Pregunta por tus finanzas, trabaja con los archivos de tu libro mayor y sigue cada cambio en Git.
Solo pregunta
Comienza con una pregunta. Sigue la respuesta hasta tu libro mayor.
Detrás de la respuesta
runBqlQuerySELECT sum(position) WHERE account ~ 'Assets|Liabilities'Beancount
Funciona con tu cliente compatible con MCP
- Claude Code
- Claude Desktop
- Cursor
- Windsurf
- Zed
Conecta el cliente que ya usas
Elige tu cliente, agrega el servidor y autoriza un libro mayor.
Claude Code
Ejecuta este comando en tu terminal.
Abre Claude Code y ejecuta /mcp para autenticarte. Inicia sesión en Web Beancount y elige tu libro mayor.
Aprueba una vez. Las credenciales se actualizan automáticamente desde aquí.
Terminal
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp¿Tienes más de un libro de contabilidad? Añade el servidor de nuevo con un nombre diferente y autoriza el otro libro en su propio mensaje:
claude mcp add --transport http beancount-business https://beancount.io/api-gateway/mcpUsa tu cuenta de Web Beancount para autorizar el acceso a un solo libro mayor.
¿No tienes una cuenta de Web Beancount? Regístrate en beancount.io — tu libro de contabilidad está a un git push de distancia.
Lo que la IA puede hacer
El servidor expone cuatro herramientas de contabilidad. La IA las compone: descubre tu estructura de archivos, lee para contexto, consulta para respuestas, propón una edición.
Cuatro herramientas con funciones claras. Tu cliente decide cómo usarlas.
listLedgerFiles
Explora la estructura de directorios de tu repositorio de contabilidad.
readLedgerFiles
Lee el contenido de tus archivos .beancount y otros documentos de contabilidad.
editLedgerFiles
Crea, actualiza, reemplaza o elimina archivos en un commit atómico de git.
Tu libro de contabilidad, protegido
Una IA con acceso de escritura a tus libros genera confianza mediante el diseño, no con promesas.
OAuth 2.1 con alcance por libro
Una sesión está autorizada para exactamente un libro. Una sesión para tu libro personal no puede tocar tu libro de negocios: radio de alcance limitado.
Vistas previas de simulación
editLedgerFiles admite un modo dry_run que valida y previsualiza los cambios exactos sin escribir nada, para que tu cliente pueda mostrarte un diff primero.
Cada edición es un commit de git
Los cambios se registran como commits reales ("AI edit: …") en el repositorio de tu libro: un registro de auditoría completo que puedes revisar y revertir con herramientas estándar de git.
Servidor sin estado
El servidor MCP no mantiene estado de sesión entre llamadas a herramientas. Tu cliente de IA y el modelo que elijas reciben los resultados que solicitas; revisa sus políticas de datos antes de conectarte.
Todo tu libro ya es un repositorio de git.
Mira cómo funciona Git for BeancountPreguntas frecuentes
Lo que debes saber antes de conectarte.
¿Curioso sobre cómo está construido?
Lee las preguntas frecuentes de ingeniería en el blog¿Qué es MCP y por qué es importante para Beancount?
MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA llamar a herramientas externas y fuentes de datos de manera estructurada y segura. En lugar de adivinar o pedirte que pegues datos, tu cliente de IA se conecta directamente a tu libro: consulta tus datos reales, lee tus archivos actuales y realiza ediciones precisas.
¿Qué clientes de IA funcionan con el servidor MCP de Beancount?
Cualquier cliente compatible con MCP que admita OAuth 2.1 funciona sin configuración adicional, incluidos Claude Code, Claude Desktop, Cursor, Windsurf y Zed. Los clientes sin soporte para OAuth 2.1 pueden conectarse con un token estático generado en la configuración de tu cuenta de beancount.io.
¿Cómo conecto mi libro de contabilidad?
Añade la URL del servidor a la configuración MCP de tu cliente. En el primer uso, el cliente abre una ventana del navegador: inicia sesión con tu cuenta de Web Beancount y elige el libro al que quieres conceder acceso. El cliente almacena y renueva las credenciales automáticamente a partir de entonces.
¿Qué puede hacer realmente la IA con mi libro de contabilidad?
El servidor expone cuatro herramientas: runBqlQuery ejecuta consultas en Beancount Query Language, listLedgerFiles navega por tu repositorio de libro mayor, readLedgerFiles lee tus documentos del libro mayor y editLedgerFiles crea, actualiza o elimina archivos en un commit atómico de git. La IA las combina para responder preguntas y proponer ediciones.
¿Puede la IA modificar mi libro de contabilidad sin que yo lo sepa?
Las ediciones se realizan a través de la herramienta editLedgerFiles, que los clientes MCP bien comportados te muestran antes de ejecutarlas. Un modo dry_run previsualiza los cambios exactos sin escribir nada, y cada cambio confirmado es un commit real de git: un registro de auditoría completo que puedes revertir con herramientas estándar de git.
¿Se envían mis datos a un tercero?
Los datos de tu libro mayor pasan por el backend de Web Beancount y regresan como resultados de herramientas a tu cliente de IA. El modelo de IA que elijas recibe esos resultados, por lo que también se aplican las políticas de datos de su proveedor. Cada sesión autorizada está limitada a un solo libro mayor.
Lleva tu libro mayor a tu próxima conversación.
El servidor MCP de Beancount está disponible hoy para todos los usuarios de Web Beancount. Tu libro de contabilidad está a un git push de distancia.