mi-sii-mcp — Servidor MCP para el SII de Chile

mi-sii-mcp — Servidor MCP para el SII de Chile

Tus impuestos del SII, conversados con tu asistente de IA.

Sitio web · Instalación · Compatibilidad · Ejemplos · Preguntas frecuentes · Guía completa · English

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.

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

Y con lo guardado, sin ir al SII:

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.

«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]
    end
    A <-- herramientas MCP --> M[mi-sii-mcp]
    M -- solo lectura --> S[(Portal del SII)]
    M <--> D[(Base local<br/>~/.mi-sii-mcp)]
    P -. conecta su cuenta .-> W[Terminal o página local<br/>login]
    W --> M

1. Conectas tu cuenta una vez, en la terminal o en una página local; la clave no pasa por el chat.
2. El asistente pide datos al servidor MCP, que los lee del SII y los guarda en tu equipo.
3. mi-sii-mcp concilia la información con reglas tributarias y responde con hallazgos claros.

Requisitos

• Node.js 22.12 o superior (probado con Node 24).
• Un cliente MCP que ejecute servidores locales (ver compatibilidad).
• Clave tributaria del SII.
• Windows es la plataforma probada; el código es multiplataforma (en macOS o Linux, conecta la cuenta con login desde la terminal o, si instalaste desde el código, con npm run local).

Instalación

Lo más simple es npx: tu asistente descarga y arranca la versión publicada en npm, sin clonar ni compilar nada. Solo necesitas Node.js 22.12 o superior.

1. Registrar el servidor en tu asistente

En un clic:

Como plugin, que trae el servidor y la skill. Dentro de Claude Code:

/plugin install mi-sii-mcp --marketplace Taksuma-0/mi-sii-mcp

En versiones anteriores a la 2.1.275, en dos pasos: /plugin marketplace add Taksuma-0/mi-sii-mcp y luego /plugin install mi-sii-mcp@mi-sii-mcp.

O solo el servidor, desde la terminal:

claude mcp add --scope user mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp

Como extensión, que trae el servidor y la skill:

gemini extensions install https://github.com/Taksuma-0/mi-sii-mcp

Como plugin, que trae el servidor y la skill:

codex plugin marketplace add Taksuma-0/mi-sii-mcp
codex plugin add mi-sii-mcp@mi-sii-mcp

El plugin ya amplía los plazos de Codex, que por defecto espera 10 segundos a que el servidor arranque y 60 por herramienta; una sincronización de 12 meses con el SII tarda más que eso.

O solo el servidor, en ~/.codex/config.toml (con codex mcp add mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp quedan los plazos por defecto: agrega después las dos últimas líneas):

[mcp_servers.mi-sii-mcp]
command = "npx"
args = ["-y", "mi-sii-mcp@latest", "mcp"]
startup_timeout_sec = 120
tool_timeout_sec = 900

Si ya lo instalaste en Claude Code (plugin o claude mcp add), Grok Build lo carga solo: lee la configuración, los plugins y las skills de Claude Code. Si no:

grok mcp add mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp

La primera vez npx descarga el paquete; si Grok corta la conexión antes, sube startup_timeout_sec = 120 en la entrada [mcp_servers.mi-sii-mcp] de ~/.grok/config.toml. Para la skill, copia la carpeta skills/mi-sii-mcp a ~/.grok/skills/. Revisa la conexión con grok mcp doctor mi-sii-mcp.

{
  "servers": {
    "mi-sii-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mi-sii-mcp@latest", "mcp"]
    }
  }
}

Agrega esto al archivo de configuración MCP de tu cliente (Claude Desktop: claude_desktop_config.json; Cursor: ~/.cursor/mcp.json; Windsurf: ~/.codeium/windsurf/mcp_config.json; Gemini CLI sin la extensión: ~/.gemini/settings.json):

{
  "mcpServers": {
    "mi-sii-mcp": {
      "command": "npx",
      "args": ["-y", "mi-sii-mcp@latest", "mcp"]
    }
  }
}

git clone https://github.com/Taksuma-0/mi-sii-mcp.git
cd mi-sii-mcp
npm install
npm run build

El servidor se inicia con node <carpeta>/dist/interfaces/cli/bin.js mcp. En las configuraciones de arriba, cambia npx por node y los argumentos por la ruta de bin.js y mcp. Por ejemplo, en Claude Code (reemplaza C:\ruta\a\mi-sii-mcp por la carpeta donde clonaste el proyecto):

claude mcp add --scope user mi-sii-mcp -- node "C:\ruta\a\mi-sii-mcp\dist\interfaces\cli\bin.js" mcp

@latest hace que npx use siempre la última versión publicada. El servidor trae sus propias instrucciones de uso para el asistente (por dónde empezar, cómo reintentar, que nunca pida la clave), así que se comporta igual con cualquier cliente.

2. Conectar tu cuenta del SII

Inicias sesión una vez y la clave nunca pasa por el chat.

Desde la terminal, con npx (cualquier sistema). Reemplaza 11111111-1 por tu RUT:

npx -y mi-sii-mcp@latest login 11111111-1 --guardar-clave

Te pide la clave tributaria sin mostrarla. Con --guardar-clave la guarda en el almacén de credenciales del sistema para que la sesión se renueve sola. Para entrar con ClaveÚnica (experimental; su sesión no se renueva sola): npx -y mi-sii-mcp@latest login-navegador --rut 11111111-1. Se abre Edge o Chrome y mi-sii-mcp no ve la clave.

Con la página local (si instalaste desde el código). En Windows, haz doble clic en Abrir mi-sii-mcp.cmd (en la carpeta del proyecto). Se abre una página local donde:

1. Escribes tu RUT (los puntos y el guion se ponen solos) y tu clave tributaria.
2. Dejas marcado Mantener conectada para que la sesión se renueve sola.
3. Pulsas Conectar.

Puedes conectar varias cuentas (tu RUT personal y tus empresas). La misma página ofrece entrar con ClaveÚnica desde el navegador; esa opción es experimental (aún no se ha probado con una cuenta real) y su sesión no se renueva sola.

En macOS o Linux, la página se abre con npm run local desde la carpeta del proyecto.

3. Preguntar

Reinicia tu asistente (en Claude Code basta con /mcp) para que cargue el servidor y pregunta, por ejemplo: «lista mis perfiles» o «trae mi renta de los últimos 3 años».

Ejemplos de consultas tributarias

El servidor trae además recetas listas (prompts MCP) que tu cliente muestra en su menú: revisión del mes, qué tengo pendiente, cierre contable, cartera semanal, preparar la renta y ahorro tributario.

Skill para agentes

El repositorio incluye una skill en el formato estándar Agent Skills (SKILL.md): skills/mi-sii-mcp. Le enseña a tu agente cuándo usar mi-sii-mcp, qué herramienta usar para cada tarea (revisión de IVA, boletas, renta, vencimientos, preguntas libres), las reglas de seguridad y cómo repartir el trabajo entre varios agentes: un solo agente consulta el SII y el resto analiza los datos guardados en paralelo.

• Claude Code: el plugin la instala junto con el servidor. También puedes copiar la carpeta skills/mi-sii-mcp a ~/.claude/skills/ (para todos tus proyectos) o a .claude/skills/ dentro de un proyecto.
• Codex: el plugin la trae.
• Gemini CLI: la extensión la trae.
• Grok Build: la toma del plugin de Claude Code, o cópiala a ~/.grok/skills/.
• Otros agentes compatibles con SKILL.md: copia la misma carpeta en su directorio de skills.

La skill complementa al servidor, que además entrega sus propias instrucciones a cualquier cliente MCP.

Herramientas del MCP

sii_panorama, renta_resumen, contabilidad_libro y contabilidad_asientos responden por defecto una versión liviana; con detalle: true traen todo.

Seguridad y privacidad

• Solo lee. Nunca presenta, modifica ni emite nada en el SII.
• Tus datos quedan en tu equipo, en una base SQLite en ~/.mi-sii-mcp; el servidor se comunica directamente con el SII, sin servidores intermedios.
• El asistente nunca recibe tu clave. El inicio de sesión lo haces tú en una página local o en la terminal; el MCP no tiene ninguna herramienta que reciba claves.
• La sesión se guarda como cookies en tu equipo para no pedirte la clave en cada consulta. Si eliges «Mantener conectada», la clave queda en el almacén de credenciales del sistema (Administrador de credenciales de Windows, Llavero de macOS o Secret Service en Linux), no en archivos.
• Las respuestas del SII que se guardan como respaldo se sanean: sin correos, direcciones, códigos de barra ni el token de la sesión. De terceros se guarda solo lo necesario (p. ej. la razón social de un pagador).
• Lo que consultas pasa a la conversación con tu asistente (y a su proveedor de IA): pregunta solo por los contribuyentes que estés dispuesto a comentar ahí.

Preguntas frecuentes

¿Qué es mi-sii-mcp?

Es un servidor MCP de código abierto que permite que un asistente de IA consulte y concilie tu información tributaria del SII de Chile: IVA, F29, renta F22, boletas de honorarios y declaraciones de terceros.

¿Qué es un servidor MCP y por qué usarlo con el SII?

MCP (Model Context Protocol) es un estándar abierto para que los asistentes de IA usen herramientas externas. Un servidor MCP para el SII le da a tu asistente herramientas para leer tus datos tributarios y aplicar reglas de conciliación, en vez de que copies y pegues información del portal.

¿Cómo conecto Claude, Codex, Gemini CLI, Grok o Cursor al SII?

Regístralo en tu cliente con npx: es un comando o un clic, sin descargar el código (ver instalación). En Claude Code y Codex también está el plugin, y en Gemini CLI la extensión, que traen el servidor y la skill; Grok Build usa lo que ya instalaste en Claude Code o se agrega con grok mcp add. Después conecta tu cuenta con login en la terminal o en la página local. Claude Code está probado, y Codex y Gemini CLI se conectan; para los demás clientes se usa su formato MCP estándar.

¿El asistente puede ver mi clave tributaria?

No. La clave se escribe solo en la página local (o en la terminal) y ninguna herramienta del MCP la recibe. Si eliges mantener la sesión, la clave queda en el almacén de credenciales de tu sistema.

¿Dónde quedan mis datos?

En tu equipo, en ~/.mi-sii-mcp. Lo que preguntas y las respuestas sí pasan por tu asistente de IA, como cualquier conversación con él.

¿Puede presentar mi F29 o emitir boletas?

No. mi-sii-mcp solo lee el portal del SII; no presenta declaraciones, no emite documentos ni modifica nada.

¿mi-sii-mcp emite facturas o usa el Sistema de Facturación Gratuito del SII?

No. mi-sii-mcp no emite facturas ni boletas, no usa el Sistema de Facturación Gratuito del SII y no descarga los archivos de las facturas electrónicas (DTE). Lee el Registro de Compras y Ventas, los F29, la renta F22, las boletas de honorarios y las declaraciones de terceros, siempre en solo lectura. Su código está en github.com/Taksuma-0/mi-sii-mcp.

¿Es una herramienta oficial del SII?

No. Es un proyecto independiente de código abierto y no reemplaza la asesoría de un contador.

¿Cuánto cuesta?

Es gratuito y de código abierto (licencia MIT). Solo necesitas un cliente MCP; el costo del asistente de IA depende de su proveedor.

¿Funciona en macOS o Linux?

El código es multiplataforma, pero la plataforma probada es Windows. En macOS o Linux, conecta la cuenta con npx -y mi-sii-mcp@latest login o, si instalaste desde el código, abre la página local con npm run local.

Uso desde la terminal (opcional)

Todo lo anterior también está disponible como comandos (si instalaste desde el código, cambia npx -y mi-sii-mcp@latest por node dist/interfaces/cli/bin.js):

npx -y mi-sii-mcp@latest --help
npx -y mi-sii-mcp@latest perfil listar
npx -y mi-sii-mcp@latest sync 11111111-1 --desde 2026-01 --hasta 2026-09
npx -y mi-sii-mcp@latest renta sync 11111111-1 --desde 2025 --hasta 2027
npx -y mi-sii-mcp@latest renta ver 11111111-1

Configuración

Variables de entorno opcionales:

Documentación

• Sitio web del proyecto
• Guía para usarlo con un asistente: instalación detallada, preguntas, herramientas y solución de problemas.
• Guía de la página local
• Decisiones de diseño: plazos del F29, áreas del SII, datos públicos de la renta y más.
• Difusión y directorios MCP: metadatos para directorios y registro en buscadores.

Desarrollo

npm test            # pruebas (solo datos ficticios; nunca consultan el SII real)
npm run typecheck   # tipos
npm run build       # compila a dist/
npm run probar:mcp  # prueba el servidor MCP compilado

El código está organizado por capas (domain, app, connectors, store, interfaces, main); test/arquitectura.test.ts verifica que se respeten.

Las contribuciones son bienvenidas. Por favor, nunca incluyas datos tributarios reales (RUT, nombres, montos) en issues, pruebas ni fixtures: usa RUT ficticios como 11.111.111-1.

Limitaciones

• La propuesta del F22 aún no se lee (el SII la publica en abril).
• Las estimaciones y simulaciones no ven sueldos, depreciación ni otros gastos sin documento tributario: si conoces la base real, infórmala.
• Las cartolas se importan en CSV o TXT; el XLSX se guarda primero como CSV desde Excel.
• La revisión diaria y sus notificaciones están hechas para Windows.
• La declaración de sueldos del empleador (DJ 1887) se lee de forma genérica: su formato no se ha verificado con datos reales.
• El inicio de sesión con ClaveÚnica desde el navegador es experimental.
• Si el SII cambia su portal, mi-sii-mcp se adapta solo cuando puede comprobarlo con los totales del SII (hoy, los montos del detalle del RCV); los demás cambios detienen la lectura sin tocar lo guardado hasta actualizar el lector, y diagnostico los muestra.

In English

mi-sii-mcp is an open-source, read-only Model Context Protocol server for Chile's Internal Revenue Service (SII). It lets AI assistants such as Claude, Codex, Gemini CLI, Grok Build, Cursor and VS Code with Copilot read a taxpayer's VAT purchase and sales records (RCV), F29 returns, income tax returns (F22), fee receipts (boletas de honorarios) and third-party sworn statements. It stores them locally in SQLite and cross-checks them for mismatches and upcoming deadlines. It also estimates the F29 and F22, reconciles bank statements and drafts bookkeeping entries. The assistant never receives the taxpayer's password.

claude mcp add --scope user mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp
npx -y mi-sii-mcp@latest login 11111111-1 --guardar-clave   # connect your SII account once

It is also a Claude Code plugin (/plugin install mi-sii-mcp --marketplace Taksuma-0/mi-sii-mcp), a Codex plugin (codex plugin marketplace add Taksuma-0/mi-sii-mcp, then codex plugin add mi-sii-mcp@mi-sii-mcp) and a Gemini CLI extension (gemini extensions install https://github.com/Taksuma-0/mi-sii-mcp); Grok Build loads it from Claude Code or with grok mcp add mi-sii-mcp -- npx -y mi-sii-mcp@latest mcp. Answers and documentation are in Spanish. Not affiliated with the SII; not tax advice.

Licencia

MIT © 2026 Welinton Barrera · Código fuente: github.com/Taksuma-0/mi-sii-mcp