mi-sii-mcp

<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/img/marca/logo-horizontal-oscuro.svg"> <img src="docs/img/marca/logo-horizontal.svg" alt="Logo de mi-sii-mcp" width="520"> </picture> </p> <h1 align="center">mi-sii-mcp — Servidor MCP para el SII de Chile</h1> <p align="center"><b>Tus impuestos del SII, conversados con tu asistente de IA.</b></p> <p align="center"> <a href="https://github.com/Taksuma-0/mi-sii-mcp/actions/workflows/pruebas.yml"><img alt="Pruebas en Windows, macOS y Linux" src="https://github.com/Taksuma-0/mi-sii-mcp/actions/workflows/pruebas.yml/badge.svg"></a> <a href="https://www.npmjs.com/package/mi-sii-mcp"><img alt="Versión en npm" src="https://img.shields.io/npm/v/mi-sii-mcp?style=flat-square&color=0f2a44&label=npm"></a> <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Taksuma-0/mi-sii-mcp"><img alt="Publicado en el MCP Registry oficial" src="https://img.shields.io/badge/MCP%20Registry-publicado-0f2a44?style=flat-square&labelColor=7cb6fb"></a> <a href="LICENSE"><img alt="Licencia MIT" src="https://img.shields.io/badge/licencia-MIT-0f2a44?style=flat-square"></a> <img alt="Open source" src="https://img.shields.io/badge/open%20source-TypeScript-0f2a44?style=flat-square&labelColor=3dd6c3"> <img alt="Node.js 22.12 o superior" src="https://img.shields.io/badge/node-%E2%89%A522.12-0f2a44?style=flat-square&logo=nodedotjs&logoColor=3dd6c3"> <a href="https://modelcontextprotocol.io"><img alt="Model Context Protocol" src="https://img.shields.io/badge/MCP-stdio-0f2a44?style=flat-square&labelColor=7cb6fb"></a> <img alt="Solo lectura" src="https://img.shields.io/badge/SII-solo%20lectura-0f2a44?style=flat-square&labelColor=3dd6c3"> </p> <p align="center"> <a href="https://glama.ai/mcp/servers/Taksuma-0/mi-sii-mcp"><img alt="mi-sii-mcp en Glama: puntuación del servidor MCP" src="https://glama.ai/mcp/servers/Taksuma-0/mi-sii-mcp/badges/score.svg"></a> <a href="https://mcpservers.org/servers/taksuma-0/mi-sii-mcp"><img alt="Listado en mcpservers.org" src="https://mcpservers.org/badge.svg"></a> <a href="https://hub.xerj.org/contributors/Taksuma-0"><img alt="Colaborador en XERJ Corpus Hub" src="https://hub.xerj.org/contributors/Taksuma-0/badge.svg"></a> </p> <p align="center"> <a href="https://taksuma-0.github.io/mi-sii-mcp/">Sitio web</a> · <a href="#instalación">Instalación</a> · <a href="#compatibilidad-con-agentes-de-ia">Compatibilidad</a> · <a href="#ejemplos-de-consultas-tributarias">Ejemplos</a> · <a href="#preguntas-frecuentes">Preguntas frecuentes</a> · <a href="docs/guias/asistente-mcp.md">Guía completa</a> · <a href="#in-english">English</a> </p>

mi-sii-mcp es un servidor Model Context Protocol (MCP) de código abierto que conecta asistentes de inteligencia artificial —Claude, Codex, Gemini CLI, Grok, Cursor, VS Code con Copilot y otros clientes MCP— con tu información tributaria del Servicio de Impuestos Internos (SII) de Chile. Lee tu IVA, tus F29, tu renta (F22), tus boletas de honorarios, lo que otros informan sobre ti y tus anotaciones en Mi SII; lo guarda en tu equipo y lo concilia para mostrarte qué cuadra, qué no y qué vence. Además estima el F29 y la renta antes de declarar, concilia tus cartolas del banco, arma libros y asientos para tu contador, te avisa cada día solo si algo requiere atención y muestra las formas legales de pagar menos, con su norma. Funciona en solo lectura frente al SII y el asistente nunca recibe tu clave.

[!NOTE] Proyecto independiente de código abierto: no está afiliado al SII ni reemplaza la asesoría de un contador. Úsalo para revisar tu información y tomar mejores decisiones.

<p align="center"> <img src="docs/img/demo-conversacion.svg" alt="Demostración con datos ficticios: el asistente consulta mi-sii-mcp y responde cuánto se ha retenido en boletas de honorarios, por pagador, y que cuadra con lo informado al SII" width="820"> </p>

---

Características principales

• Consultas tributarias en lenguaje natural: pregúntale a tu asistente por tu IVA, tus F29, tu renta o tus boletas de honorarios, con tus datos reales del SII.
• Conciliación automática: cruza el registro de compras y ventas con el F29, las boletas con la renta y lo que informan tus pagadores con tus propios registros.
• Alertas útiles: F29 sin presentar o por vencer (día 12, 20 o 28 según tu caso), facturas por reclamar, descuadres y anotaciones vigentes del SII.
• F29 y renta estimados: calcula el F29 del mes (débito, crédito, remanente, PPM y retenciones) y el F22 de una persona antes de declararlos, y los compara con lo presentado.
• Banco y contabilidad: importa cartolas en CSV de cualquier banco, las concilia con facturas, boletas e impuestos, y arma libros, asientos y el resultado del período, exportables a Excel.
• Revisión diaria: con un clic en la página local, revisa todas tus cuentas cada día y te avisa con una notificación de Windows solo cuando hay algo nuevo.
• Ahorro tributario legal: oportunidades que tus datos sostienen (crédito de IVA por usar, postergación del IVA, gastos efectivos, APV), cada una con su norma y la página oficial; simula el régimen Pro Pyme y proyecta el cierre del año.
• Cartera: para quien lleva varias empresas, una vista de qué cuenta necesita atención.
• Se adapta a los cambios del SII: nota cuando el SII cambia sus respuestas; si renombra un monto, lo encuentra solo comprobándolo al peso con los totales del propio SII; si no puede comprobarlo, se detiene antes de guardar datos malos y avisa. Con diagnostico ves su salud.
• Resiliente: si el SII no responde, se detiene en vez de insistir; si la sesión vence a mitad de camino y guardaste la clave, entra de nuevo sola; lo que falló se reintenta en la revisión diaria; la base se respalda cada día.
• Respuestas livianas: JSON compacto y versiones resumidas por defecto (detalle: true trae todo), para que el asistente responda más rápido.
• Solo lectura: nunca presenta, modifica ni emite nada en el SII.
• Datos locales: todo se guarda en una base SQLite en tu equipo; no hay servidores intermedios.
• La clave no pasa por el chat: inicias sesión en una página local y ninguna herramienta del MCP recibe claves.
• Varias cuentas: tu RUT personal y los de tus empresas, cada uno con su propia sesión.
• Open source (MIT), escrito en TypeScript, con más de 1.600 pruebas automáticas que usan solo datos ficticios.

Qué lee del SII y qué concilia

| Área | Qué trae del SII | Qué concilia | | --- | --- | --- | | IVA | Registro de Compras y Ventas (RCV), F29 presentados (con su PDF) y propuesta de F29 | IVA del RCV contra el F29, F29 faltantes, facturas por reclamar y coherencia interna del F29 | | Boletas de honorarios | Recibidas (por mes) y emitidas (resumen anual y detalle boleta por boleta) | Retención de las boletas contra el F29 (código 151) y contra la renta (códigos 547 y 492) | | Renta (F22) | Declaraciones por año tributario, folio vigente, códigos, observaciones y eventos (devoluciones, giros), y lo que el SII prepara para el F22 (PPM y comparativo F29-RCV) | Boletas emitidas y lo informado por terceros contra el F22; los PPM del SII contra tus F29 | | Informado por terceros | Declaraciones juradas que otros presentan sobre ti (p. ej. retenciones de honorarios) | Lo que informa cada pagador contra tus boletas y tu F22; avisa si el SII observó la declaración de un informante | | Cuenta | Perfil tributario (régimen, segmento, autorización para declarar el F29 hasta el día 20) y empresas autorizadas | Vencimientos del F29 según tu caso | | Mi SII | Anotaciones vigentes (p. ej. F29 no presentado, que puede impedir emitir documentos), estado de cumplimiento y mensajes | Las convierte en avisos de la revisión diaria |

Y con lo guardado, sin ir al SII:

| Área | Qué hace | | --- | --- | | Estimaciones | F29 del mes antes de declararlo y F22 de una persona (con los datos públicos del año); proyección del cierre del año contra los PPM pagados | | Banco | Importa cartolas CSV, concilia cada movimiento con facturas, boletas, F29 y F22, y muestra las cuentas por cobrar y por pagar por antigüedad | | Contabilidad | Plan de cuentas base, libros de compras, ventas, honorarios y banco, propuesta de asientos que cuadran y resultado devengado o percibido, exportables a CSV | | Seguimiento | Revisión diaria con avisos sin repetir, novedades y el estado de toda la cartera | | Ahorro legal | Oportunidades con su norma y página oficial, y simulación Pro Pyme General frente a Transparente |

Los datos públicos (UTM, tablas de impuestos, tasas de cotización, comisiones de AFP) no se guardan: la herramienta fuentes_oficiales indica en qué página oficial consultarlos para el año que corresponda.

Qué no hace

mi-sii-mcp (repositorio oficial: github.com/Taksuma-0/mi-sii-mcp) sirve para consultar y conciliar tu información tributaria. Para no confundirlo con otros proyectos de nombre parecido:

• No emite facturas, boletas ni otros documentos, y no usa el Sistema de Facturación Gratuito del SII (MiPyme).
• No presenta ni rectifica declaraciones (F29, F22) ni modifica nada en el portal.
• No descarga los archivos XML o PDF de las facturas electrónicas (DTE): lee el detalle del Registro de Compras y Ventas.
• No opera el portal con un navegador automatizado: consulta el SII directamente y solo abre el navegador, si tú lo eliges, para iniciar sesión con ClaveÚnica.
• No envía tus datos a servidores de terceros: todo queda en tu equipo. Solo escribe en tu equipo: la base, los archivos que exportas y la tarea de la revisión diaria si la activas.
• No es una contabilidad completa: propone libros y asientos para revisar con tu contador.
• No sugiere operaciones para pagar menos: solo muestra beneficios que la ley ya permite, con su norma; simular gastos o contratos es elusión o fraude.
• No consulta la Tesorería (deudas y giros) por ahora.
• No se actualiza sola: avisa cuando hay una versión nueva en npm (una consulta al día a registry.npmjs.org, sin datos tuyos; se apaga con MI_SII_MCP_SIN_AVISO_VERSION=1), pero no instala nada.

Compatibilidad con agentes de IA

mi-sii-mcp es un servidor MCP local (transporte stdio), así que funciona con los clientes que ejecutan servidores MCP locales.

| Cliente | Estado | Cómo se configura | | --- | --- | --- | | Claude Code | ✅ Probado | Plugin (/plugin install) o claude mcp add (ver instalación) | | Codex (OpenAI) | ✅ Conexión probada | Plugin (codex plugin add) o ~/.codex/config.toml | | Gemini CLI | ✅ Conexión probada | Extensión (gemini extensions install) o ~/.gemini/settings.json | | Grok Build (xAI) | Configuración documentada | grok mcp add; también lee lo que ya instalaste en Claude Code | | Claude Desktop | Configuración documentada | claude_desktop_config.json (formato mcpServers) | | Cursor | Configuración documentada | Botón de instalación o ~/.cursor/mcp.json | | VS Code con GitHub Copilot | Configuración documentada | Botón de instalación o .vscode/mcp.json | | Windsurf, Cline y otros | Configuración documentada | Formato mcpServers |

«Configuración documentada» significa que se usa el formato MCP estándar de cada cliente. «Conexión probada» significa que el cliente instaló el servidor y se conectó a él en Windows. El desarrollo y las pruebas en vivo se hicieron con Claude Code.

Cómo funciona

flowchart LR
    P([Tú]) -- preguntas --> A
    subgraph A [Tu asistente con MCP]
        direction TB
        A1[Claude Code / Desktop]
        A2[Cursor · Windsurf · Cline]
        A3[VS Code + Copilot]
        A4[Codex · Gemini CLI · Grok]
    en