Servidor MCP de Copilot Money

Consulta y gestiona tus finanzas personales con IA utilizando datos locales de Copilot Money

Aviso legal

Este es un proyecto independiente impulsado por la comunidad y no está afiliado, respaldado ni asociado de ninguna manera con Copilot Money o su empresa matriz. Esta herramienta fue creada por un desarrollador independiente para permitir consultas mediante IA de datos almacenados en caché localmente. "Copilot Money" es una marca comercial de su respectivo propietario.

Descripción general

Un servidor MCP que brinda a los asistentes de IA acceso a tus datos de finanzas personales de Copilot Money. Lee desde la base de datos de Firestore almacenada en caché localmente (LevelDB + Protocol Buffers) en tu Mac. Las lecturas son 100% locales sin solicitudes de red. El modo de escritura opcional (activado mediante --write) envía los cambios solicitados directamente al backend de Firebase/Firestore de Copilot Money —el mismo backend que utiliza la propia aplicación Copilot Money— autenticado con tus propias credenciales, nunca a través de ningún servicio de terceros.

35 herramientas que abarcan gastos, inversiones, presupuestos, objetivos y más:

• 17 herramientas de lectura: consulta transacciones, cuentas, participaciones, saldos, categorías, cargos recurrentes, presupuestos, objetivos, rendimiento de inversiones y más.

• 18 herramientas de escritura (opcionales): consolida cambios en transacciones, gestiona etiquetas, crea presupuestos, actualiza elementos recurrentes y organiza tus finanzas.

Solo lectura por defecto. Las herramientas de escritura requieren iniciar explícitamente el servidor con --write para habilitarlas.

Privacidad ante todo

Nunca recopilamos, almacenamos ni transmitimos tus datos a ningún servidor operado por este proyecto; no tenemos ninguno. Consulta nuestra Política de privacidad para obtener más detalles.

• Sin analíticas, telemetría ni seguimiento de ningún tipo.

• Las lecturas son totalmente locales: cero solicitudes de red.

• Solo lectura por defecto (herramientas de escritura deshabilitadas a menos que pases --write).

• En el modo de escritura opcional, las solicitudes van directamente desde tu máquina al backend de Firebase/Firestore de Copilot Money utilizando tus propias credenciales, nunca a través de servicios de terceros.

• Código abierto: verifica el código tú mismo.

Inicio rápido

Requisitos previos

• Node.js 18+ (viene incluido con Claude Desktop)

• Copilot Money (versión de la App Store de macOS)

• Claude Desktop, Cursor o cualquier cliente compatible con MCP

Instalación mediante Claude Desktop

1. Descarga el paquete .mcpb más reciente desde Releases

2. Haz doble clic en el archivo .mcpb para instalarlo en Claude Desktop

3. Reinicia Claude Desktop

4. ¡Empieza a hacer preguntas sobre tus finanzas!

Instalación mediante npm

npm install -g copilot-money-mcp

Luego, añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Instalación para Cursor

1. Instala el paquete globalmente:

npm install -g copilot-money-mcp

2. Abre la configuración de Cursor (Cmd + ,) > Features > MCP Servers

3. Añade la configuración del servidor:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Qué puedes hacer

Análisis de gastos

"¿Cuánto gasté en comer fuera el mes pasado?"

"Muéstrame todas mis compras en Amazon en los últimos 30 días"

"¿Cuáles son mis 5 categorías de gasto principales este año?"

Utiliza get_transactions, get_categories con rangos de fechas, búsqueda de texto y filtros de categoría.

Resumen de cuentas

"¿Cuál es mi patrimonio neto en todas las cuentas?"

"Muéstrame el saldo de mi cuenta corriente de los últimos 6 meses, mes a mes"

"¿Qué conexiones bancarias necesitan atención?"

Utiliza get_accounts, get_balance_history, get_connection_status.

Cartera de inversiones

"¿Cuáles son mis participaciones actuales y mis rendimientos totales?"

"Muéstrame el historial de precios de AAPL del último año"

"¿Cuál es mi rendimiento ponderado en el tiempo este trimestre?"

Utiliza get_holdings, get_investment_prices, get_securities, get_investment_performance, get_twr_returns.

Presupuestos y objetivos

"¿Estoy cumpliendo con mis presupuestos este mes?"

"¿Cómo va progresando mi fondo de emergencia?"

"Muéstrame mi historial de objetivos de los últimos 6 meses"

Utiliza get_budgets, get_goals, get_goal_history.

Suscripciones y cargos recurrentes

"¿Qué suscripciones estoy pagando?"

"¿Cuánto gasto en cargos recurrentes al mes?"

Utiliza get_recurring_transactions.

Organización de tus finanzas (Modo escritura)

"Categoriza todas mis transacciones de Uber como transporte"

"Etiqueta mis gastos de vacaciones con #vacaciones"

"Crea un presupuesto mensual de $500 para comidas"

"Configura Netflix como un cargo recurrente mensual"

Utiliza herramientas de escritura como update_transaction, create_budget, update_recurring y más. Requiere la bandera --write.

Herramientas disponibles

Herramientas de lectura (17)

Herramientas de escritura (18) — requiere la bandera --write

Modo escritura

Por defecto, el servidor se inicia en modo de solo lectura. Para habilitar las herramientas de escritura, inicia el servidor con la bandera --write:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp",
      "args": ["--write"]
    }
  }
}

Las herramientas de escritura modifican tus datos de Copilot Money enviando solicitudes autenticadas directamente al backend de Firebase/Firestore de Copilot Money —el mismo backend que utiliza la aplicación Copilot Money— por lo que tus cambios se reflejan inmediatamente en tu cuenta. Las escrituras se autentican utilizando un token de actualización de Firebase extraído de tu sesión local de Copilot Money; tus credenciales nunca salen de tu máquina excepto en la solicitud autenticada a los puntos finales de Firebase/Firestore de Google. No intervienen servicios de terceros. Consulta PRIVACY.md para obtener todos los detalles.

Configuración

TTL de caché

El servidor almacena datos en memoria durante 5 minutos. Configúralo mediante la variable de entorno:

# Set cache TTL to 10 minutes
COPILOT_CACHE_TTL_MINUTES=10 copilot-money-mcp

# Disable caching (always reload from disk)
COPILOT_CACHE_TTL_MINUTES=0 copilot-money-mcp

También puedes actualizar manualmente usando la herramienta refresh_database.

Tiempo de espera de decodificación

Para bases de datos grandes (más de 500 MB), aumenta el tiempo de espera de decodificación (por defecto: 90 segundos):

# Via environment variable
DECODE_TIMEOUT_MS=600000 copilot-money-mcp

# Via CLI flag
copilot-money-mcp --timeout 600000

Para bases de datos de más de 1 GB, aumenta también la memoria de Node.js:

{
  "mcpServers": {
    "copilot-money": {
      "command": "node",
      "args": [
        "--max-old-space-size=4096",
        "/path/to/copilot-money-mcp/dist/cli.js",
        "--timeout", "600000"
      ]
    }
  }
}

Periodos de fecha admitidos

El parámetro period admite estos atajos:

this_month last_month last_7_days last_30_days last_90_days ytd this_year last_year

Limitaciones conocidas

Dependencia de caché local

Este servidor lee desde la caché local de Firestore de Copilot Money, no desde la nube. La persistencia sin conexión de Firestore almacena en caché cada documento que la aplicación ha recuperado, por lo que la base de datos local generalmente contiene todas las transacciones, cuentas, presupuestos, objetivos y otros datos que has visto en la aplicación. El tamaño predeterminado de la caché de Firestore es de 100 MB (suficiente para decenas de miles de transacciones), y los documentos más antiguos solo se eliminan mediante la recolección de basura LRU si se supera ese límite.

Para maximizar los datos almacenados en caché: Abre la aplicación Copilot Money y navega por tus datos (historial de transacciones, cuentas, presupuestos) para asegurarte de que se hayan recuperado y almacenado en caché localmente.

Solución de problemas

Base de datos no encontrada

Si ves "Database not available":

1. Asegúrate de que Copilot Money esté instalado y haya sincronizado los datos

2. Comprueba la ubicación de la base de datos: ~/Library/Containers/com.copilot.production/Data/Library/Application Support/firestore/__FIRAPP_DEFAULT/copilot-production-22904/main

3. Verifica que los archivos .ldb existan en el directorio

4. Proporciona una ruta personalizada: copilot-money-mcp --db-path /ruta/a/la/base/de/datos

Tiempo de espera de trabajador de decodificación agotado

Si ves "Decode worker timed out":

1. Aumenta el tiempo de espera: copilot-money-mcp --timeout 300000 (5 minutos)

2. Para bases de datos de más de 1 GB, aumenta también la memoria de Node.js: node --max-old-space-size=4096 dist/cli.js --timeout 300000

No se encontraron transacciones

• Abre la aplicación Copilot Money y espera a que se sincronice

• Es posible que la estructura de la base de datos haya cambiado: abre un issue

Contribución

Consulta CONTRIBUTING.md para la configuración de desarrollo, la arquitectura y cómo añadir nuevas herramientas.

Licencia

Licencia MIT - Consulta LICENSE para obtener más detalles.

Agradecimientos

• Creado con MCP SDK por Anthropic

• Validación de datos con Zod

• Desarrollado con Bun