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, añade el servidor una vez y autoriza los libros contables a los que puede acceder.
Claude Code
Ejecuta este comando en tu terminal.
Abre Claude Code y ejecuta /mcp para autenticarte. Inicia sesión en Web Beancount y aprueba un libro contable o todos ellos.
Aprueba una vez. Las credenciales se actualizan automáticamente desde aquí.
Terminal
claude mcp add --transport http beancount https://beancount.io/api-gateway/mcp¿Más de un libro contable? Apruébalos todos de una vez. El asistente llama a listLedgers para ver a qué puede acceder e indica el nombre del libro contable en cada llamada, así que un único servidor cubre todos los libros.
Usa tu cuenta de Web Beancount para autorizar a qué libros contables puede acceder el servidor.
¿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 herramientas específicas para tu ledger y tus conexiones bancarias; abajo se muestran los verbos del ledger. La IA las combina: descubrir la estructura de tus archivos, leer el contexto, consultar respuestas, proponer una edición.
Herramientas de ledger y de banco. 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.
updateLedgerFiles
Cambia archivos en un commit atómico de git, con vista previa dry_run; createLedgerFiles y deleteLedgerFiles los añaden y los eliminan.
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
Tú eliges a qué puede acceder una conexión: a un único libro contable o a todos ellos. Si autorizas solo tu libro contable personal, la conexión no podrá tocar los libros de tu empresa: tú defines el alcance del impacto.
Vistas previas de simulación
Las herramientas de archivos (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles) y appendLedgerText admiten un modo dry_run que valida y previsualiza los cambios exactos sin escribir nada, para que tu cliente pueda mostrarte primero un diff.
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¿Estás evaluando otros servidores MCP de contabilidad?
Cómo se compara Beancount MCP con QuickBooks, Xero y Expensify¿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 si puede acceder a un único libro contable o a todos ellos. A partir de ahí, el cliente almacena y renueva las credenciales automáticamente.
¿Qué puede hacer realmente la IA con mi libro de contabilidad?
El servidor expone una herramienta por operación; el manifiesto de descubrimiento legible por máquinas en beancount.io/.well-known/ enumera el conjunto actual. Las herramientas de ledger ejecutan consultas de Beancount Query Language (runBqlQuery), exploran el repositorio (listLedgerFiles), leen documentos del ledger (readLedgerFiles), añaden directivas en orden de fecha (appendLedgerText) y crean, cambian o eliminan archivos en un commit atómico de git (createLedgerFiles, updateLedgerFiles, deleteLedgerFiles, cada una con un modo de vista previa dry_run). Las herramientas bancarias obtienen, importan o descartan transacciones pendientes y gestionan las conexiones vinculadas; un banco nuevo se vincula en el navegador, no por MCP. Las claves de API y la configuración de la cuenta se quedan en la aplicación web de Beancount.io. La IA combina las herramientas para responder preguntas y proponer ediciones.
¿Puede la IA modificar mi libro de contabilidad sin que yo lo sepa?
Las directivas nuevas pasan por appendLedgerText, y los cambios de archivos por las herramientas de archivos: createLedgerFiles, updateLedgerFiles, deleteLedgerFiles. Un modo dry_run previsualiza los cambios previstos sin confirmar nada, y que tu cliente pregunte antes de un commit real depende del cliente. Cada cambio confirmado queda como un commit real de git: un registro de auditoría completo que puedes revertir con las herramientas estándar de git. El proceso de commit puede informar errores de validación después de escribir, así que previsualiza primero y verifica el ledger después.
¿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 aplican las políticas de datos de su proveedor. Una conexión solo accede a los libros mayor que autorizaste: uno o todos.
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.