quicken-mac-mcp

Una habilidad de Claude + servidor MCP que le da a Claude acceso de solo lectura a tus datos financieros de Quicken For Mac. Pregúntale a Claude sobre tus cuentas, transacciones, gastos por categoría, tendencias mensuales, inversiones y más.

La base de datos siempre se abre en modo de solo lectura: tus datos de Quicken nunca se modifican.

¿Habilidad o MCP? ¿Qué necesito?

Este repositorio incluye dos artefactos que comparten el mismo conocimiento de esquema (docs/schema.md):

• Habilidad (plugin/skills/quicken/SKILL.md) — enseña a Claude a leer la base de datos SQLite de Quicken directamente con la CLI sqlite3. Funciona en Claude Code y cualquier otra interfaz de Claude que cargue habilidades. Sin instalación de módulos nativos, sin proceso de servidor MCP, solo SQL. Este es el camino recomendado.

• Servidor MCP — envuelve las mismas recetas SQL como ocho herramientas preempaquetadas (list_accounts, query_transactions, spending_by_category, …). Úsalo cuando trabajes en un cliente MCP que no sea de Claude (Cursor, Cline, puentes mcp-remote) que no pueda cargar habilidades, o cuando prefieras llamar a herramientas tipadas en lugar de que Claude escriba SQL.

La instalación del plugin de Claude Code (claude plugin install quicken-mac-mcp) incluye ambos, con la habilidad como opción principal y las herramientas MCP disponibles como atajos.

Related MCP server: banktivity-mcp

Requisitos

Quicken For Mac debe estar abierto mientras usas la habilidad o el MCP. Quicken cifra su archivo de base de datos cuando la aplicación está cerrada; los datos solo son legibles mientras Quicken se está ejecutando.

Cómo funciona

Quicken For Mac almacena los datos en una base de datos SQLite de Core Data dentro de un paquete .quicken en tu carpeta de Documentos (por ejemplo, ~/Documents/MyFinances.quicken/data). La habilidad enseña a Claude cómo consultar esa base de datos directamente; el servidor MCP es un envoltorio ligero que expone ocho consultas preempaquetadas como herramientas.

Instalación — recomendado (Claude Code, plugin)

claude plugin install quicken-mac-mcp

Esto instala tanto la habilidad /quicken (camino recomendado) como el servidor MCP. Claude priorizará la habilidad y recurrirá a las herramientas MCP cuando sea conveniente.

Instalación — caminos solo para MCP

Úsalos si estás en un cliente que no es Claude Code y no puede cargar habilidades, o si solo quieres el envoltorio de herramientas tipadas.

Claude Code (solo MCP)

claude mcp add quicken -- npx -y quicken-mac-mcp

Claude Desktop (arrastrar y soltar MCPB)

Descarga quicken-mac-mcp.mcpb desde el último lanzamiento de GitHub y arrástralo a Claude Desktop. Te pedirá la ruta de tu base de datos (o la detectará automáticamente).

Claude Desktop (JSON manual)

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"]
    }
  }
}

Reinicia Claude Desktop y verás un icono de martillo con 8 herramientas disponibles.

Ruta de base de datos personalizada

Si tienes varios archivos de Quicken, o tu paquete .quicken no está en ~/Documents, establece la variable de entorno QUICKEN_DB_PATH:

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"],
      "env": {
        "QUICKEN_DB_PATH": "/path/to/YourFile.quicken/data"
      }
    }
  }
}

Por defecto, el servidor detecta automáticamente tu base de datos de Quicken seleccionando el paquete .quicken modificado más recientemente en ~/Documents.

Herramientas MCP

Estas son las ocho herramientas preempaquetadas que expone el servidor MCP. La habilidad cubre el mismo terreno (y más) escribiendo SQL directamente contra la base de datos; consulta plugin/skills/quicken/SKILL.md.

Ejemplos de prompts

• "Lista mis cuentas"

• "¿Cuánto gasté en comestibles el mes pasado?"

• "Muestra mis gastos por categoría para 2024"

• "¿Cómo han cambiado mis gastos mensuales durante el último año?"

• "Encuentra todas las transacciones de Costco superiores a $100"

• "¿Cuáles son mis 10 principales beneficiarios por número de transacciones?"

• "Compara mis gastos en comida en 2024 vs 2025"

Esquema de la base de datos

Quicken For Mac utiliza Core Data con estas tablas clave:

Las fechas utilizan la época de Core Data (segundos desde el 01-01-2001). El servidor MCP maneja toda la conversión de fechas automáticamente; tú pasas fechas ISO 8601 y devuelve fechas ISO 8601. Las recetas de la habilidad muestran la conversión (+ 978307200) en línea para que Claude pueda escribir SQL directamente.

Los tipos de cuenta se almacenan como cadenas en mayúsculas: CHECKING, CREDITCARD, SAVINGS, MORTGAGE, RETIREMENTIRA, ASSET, LIABILITY, LOAN, etc. Las herramientas aceptan cualquier formato de mayúsculas/minúsculas.

Para la referencia completa del esquema (84 entidades, todas las tablas, índices, claves foráneas y semántica de escritura de Core Data, incluido el bloqueo optimista Z_OPT), consulta docs/schema.md.

Desarrollo

git clone https://github.com/dweekly/quicken-mac-mcp.git
cd quicken-mac-mcp
npm install
npm test          # run tests
npm run lint      # eslint
npm run format    # prettier
npm run dev       # run server locally

Docker

docker build -t quicken-mac-mcp .
docker run --rm -v ~/Documents/YourFile.quicken:/data:ro quicken-mac-mcp

Colaboradores

• Manish Mukherjee — corrigió la búsqueda