Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Actual Budget MCP Server

de s-stefanovversión 1.15.1i★ 291iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.s-stefanov/actual-mcp

Cómo instalar

What it does

MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.

  • Connects Se ejecuta en tu computadora
  • Account or key Needs ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD · 2 settings to fill in (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID)
  • Category Contabilidad, finanzas e impuestos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad36/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso48/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 3 (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Actual Budget MCP Server. Sigue https://mcp.popnx.com/i/s-stefanov-actual-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Actual Budget MCP Server para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "actual": { "command": "npx", "args": [ "-y", "actual-mcp" ], "env": { "ACTUAL_SERVER_URL": "your-value", "ACTUAL_PASSWORD": "your-value", "ACTUAL_BUDGET_SYNC_ID": "your-value", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Actual Budget MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Actual Budget MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Actual Budget MCP Server ↗

  3. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • ACTUAL_SERVER_URL URL de tu servidor de Actual Budget
      Ver original en inglésURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID ID de sincronización del presupuesto
      Ver original en inglésBudget sync ID

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  4. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  5. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "actual": {
          "command": "npx",
          "args": [
            "-y",
            "actual-mcp"
          ],
          "env": {
            "ACTUAL_SERVER_URL": "your-value",
            "ACTUAL_PASSWORD": "your-value",
            "ACTUAL_BUDGET_SYNC_ID": "your-value",
            "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Cierra Claude y vuelve a abrirlo

  7. Pruébalo

    Usa Actual Budget MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Actual Budget MCP Server o muestra una herramienta de Actual Budget MCP Server en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • ACTUAL_DATA_DIR Directorio local para los datos de presupuesto en caché
    Ver original en inglésLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS TTL de la caché de sincronización en ms
    Ver original en inglésSync cache TTL in ms
    · valor por defecto 60000

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Actual Budget MCP Server

Actual Budget MCP Server se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Actual Budget MCP Server

  • Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Actual Budget MCP Server para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user actual --env ACTUAL_SERVER_URL=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value -- npx -y actual-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Actual Budget MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Actual Budget MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Actual Budget MCP Server ↗

  3. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • ACTUAL_SERVER_URL URL de tu servidor de Actual Budget
      Ver original en inglésURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID ID de sincronización del presupuesto
      Ver original en inglésBudget sync ID

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  4. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  5. Pega este comando y pulsa Enter

    claude mcp add --scope user actual --env ACTUAL_SERVER_URL=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value -- npx -y actual-mcp

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Escribe /mcp en Claude Code

    Deberías ver Actual Budget MCP Server en la lista como conectado

  7. Pruébalo

    Usa Actual Budget MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Actual Budget MCP Server o muestra una herramienta de Actual Budget MCP Server en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • ACTUAL_DATA_DIR Directorio local para los datos de presupuesto en caché
    Ver original en inglésLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS TTL de la caché de sincronización en ms
    Ver original en inglésSync cache TTL in ms
    · valor por defecto 60000

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Actual Budget MCP Server para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "actual": { "command": "npx", "args": [ "-y", "actual-mcp" ], "env": { "ACTUAL_SERVER_URL": "your-value", "ACTUAL_PASSWORD": "your-value", "ACTUAL_BUDGET_SYNC_ID": "your-value", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Actual Budget MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Actual Budget MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Actual Budget MCP Server ↗

  3. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • ACTUAL_SERVER_URL URL de tu servidor de Actual Budget
      Ver original en inglésURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID ID de sincronización del presupuesto
      Ver original en inglésBudget sync ID

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  4. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Actual Budget MCP Server, ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de Cursor en modo Agent

  7. Pruébalo

    Usa Actual Budget MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Actual Budget MCP Server o muestra una herramienta de Actual Budget MCP Server en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • ACTUAL_DATA_DIR Directorio local para los datos de presupuesto en caché
    Ver original en inglésLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS TTL de la caché de sincronización en ms
    Ver original en inglésSync cache TTL in ms
    · valor por defecto 60000

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Actual Budget MCP Server (créala en el sitio del autor) · 2 ajuste(s) que rellenar (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Actual Budget MCP Server para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "actual": { "type": "stdio", "command": "npx", "args": [ "-y", "actual-mcp" ], "env": { "ACTUAL_SERVER_URL": "your-value", "ACTUAL_PASSWORD": "your-value", "ACTUAL_BUDGET_SYNC_ID": "your-value", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Actual Budget MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Regístrate y crea una clave de Actual Budget MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Actual Budget MCP Server ↗

  3. Rellena 2 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • ACTUAL_SERVER_URL URL de tu servidor de Actual Budget
      Ver original en inglésURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID ID de sincronización del presupuesto
      Ver original en inglésBudget sync ID

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  4. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Actual Budget MCP Server, ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de VS Code en modo Agent

  7. Pruébalo

    Usa Actual Budget MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Actual Budget MCP Server o muestra una herramienta de Actual Budget MCP Server en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • ACTUAL_DATA_DIR Directorio local para los datos de presupuesto en caché
    Ver original en inglésLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS TTL de la caché de sincronización en ms
    Ver original en inglésSync cache TTL in ms
    · valor por defecto 60000

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Actual Budget MCP Server💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user actual --env ACTUAL_SERVER_URL=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value -- npx -y actual-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "actual": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_PASSWORD": "your-value",
        "ACTUAL_BUDGET_SYNC_ID": "your-value",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "actual": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_PASSWORD": "your-value",
        "ACTUAL_BUDGET_SYNC_ID": "your-value",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "actual": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_PASSWORD": "your-value",
        "ACTUAL_BUDGET_SYNC_ID": "your-value",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
      }
    }
  }
}

Valores que debes completar

  • ACTUAL_SERVER_URL obligatorio env
    URL de tu servidor de Actual Budget
    Ver original en inglésURL of your Actual Budget server
  • ACTUAL_PASSWORD secreto obligatorio env
    Contraseña del servidor de Actual Budget
    Ver original en inglésActual Budget server password
  • ACTUAL_BUDGET_SYNC_ID obligatorio env
    ID de sincronización del presupuesto
    Ver original en inglésBudget sync ID
  • ACTUAL_DATA_DIR env
    Directorio local para los datos de presupuesto en caché
    Ver original en inglésLocal dir for cached budget data
  • ACTUAL_BUDGET_ENCRYPTION_PASSWORD secreto obligatorio env
    Contraseña de cifrado E2E, si está habilitado
    Ver original en inglésE2E encryption password, if enabled
  • ACTUAL_SYNC_TTL_MS env
    TTL de la caché de sincronización en ms
    Ver original en inglésSync cache TTL in ms

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
672/sem
Conexión
Se ejecuta en tu computadora
Transporte
stdio, streamable-http
Última versióni
1.15.1
Publicado en el registroi
20 oct 2026
Último cambio de códigoi
18 nov 2026
Creador
s-stefanov
Paquetes
npm: actual-mcp
npm: actual-mcp
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub s-stefanov, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: ayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para actual-mcp@1.15.1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/s-stefanov-actual-mcp.svg)](https://mcp.popnx.com/en/servers/s-stefanov-actual-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

  • Más estrellas que el 99% de los otros 3407 servidores de esta categoría
  • Publicado en el registro más recientemente que el 51% de los otros 3407 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3407 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Actual Budget MCP Server?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (1.15.1) llegó al registro hace 30 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 989Actualizado hace 10 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

de signal8aiEn crecimiento↓ 431/sem★ 425Actualizado hace 10 días

Computadora o nube✓ del servicio · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

de CursivezEn crecimiento★ 261Actualizado hace 11 días

Se ejecuta en la nube✓ del servicio · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

de bex-coEn crecimiento★ 688 Estrellas de todo el repositorioActualizado hace 44 días

Se ejecuta en la nube✓ del servicio · beancount.io
Comparado con otros parecidos
Este
Actual Budget MCP Server
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipo
Necesita claveSíNoSíNoNoSí
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/65/54/44/45/5
LicenciaMITMITMITNOASSERTIONMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Actual Budget MCP Server

MCP server for integrating Actual Budget with Claude and other LLM assistants.

Overview

The Actual Budget MCP Server allows you to interact with your personal financial data from Actual Budget using natural language through LLMs. It exposes your accounts, transactions, and financial metrics through the Model Context Protocol (MCP).

Features

Resources
  • Account Listings - Browse all your accounts with their balances
  • Account Details - View detailed information about specific accounts
  • Transaction History - Access transaction data with complete details
Tools
Transaction & Account Management
  • `get-transactions` - Retrieve and filter transactions by account, date, amount, category, or payee
  • `create-transaction` - Create a new transaction in an account with optional category, payee, and notes
  • `update-transaction` - Update an existing transaction with new category, payee, notes, or amount
  • `get-accounts` - Retrieve a list of all accounts with their current balance and ID
  • `balance-history` - View account balance changes over time
Reporting & Analytics
  • `spending-by-category` - Generate spending breakdowns categorized by type
  • `monthly-summary` - Get monthly income, expenses, and savings metrics
  • `budget-vs-actual` - Compare budgeted amounts against actual spending per category
  • `net-worth` - Track assets, liabilities, and net worth across all accounts over time
  • `category-trends` - See how spending in each category moves month over month, with trend direction
  • `spending-by-payee` - Rank payees by how much was spent with (or received from) each one
  • `cash-flow` - Report income, expenses, and net cash flow per month or week

The five tools above return JSON rather than markdown, so amounts stay machine-readable. Every amount is an integer number of cents, and each response carries an amountsIn field describing the sign conventions it uses.

Custom Reports & Dashboards
  • `get-custom-reports` - Retrieve every saved custom report from the Reports section
  • `create-custom-report` - Create a saved custom report
  • `update-custom-report` - Update fields on a saved custom report, leaving the rest unchanged
  • `delete-custom-report` - Delete a saved custom report
  • `get-dashboards` - Retrieve every dashboard page and the widgets laid out on it
  • `add-dashboard-widget` - Add a widget to a dashboard page
  • `update-dashboard-widget` - Update a widget's configuration, position, or size
  • `remove-dashboard-widget` - Remove a widget from its page
  • `organize-dashboard` - Reposition and resize several widgets at once
  • `create-dashboard-page` / `rename-dashboard-page` / `delete-dashboard-page` - Manage dashboard pages
Categories
  • `get-grouped-categories` - Retrieve a list of all category groups with their categories
  • `create-category` - Create a new category within a category group
  • `update-category` - Update an existing category's name or group
  • `delete-category` - Delete a category
  • `create-category-group` - Create a new category group
  • `update-category-group` - Update a category group's name
  • `delete-category-group` - Delete a category group
Payees
  • `get-payees` - Retrieve a list of all payees with their details
  • `create-payee` - Create a new payee
  • `update-payee` - Update an existing payee's details
  • `delete-payee` - Delete a payee
  • `merge-payees` - Merge duplicate payees into a single target payee
Rules
  • `get-rules` - Retrieve a list of all transaction rules
  • `create-rule` - Create a new transaction rule with conditions and actions
  • `update-rule` - Update an existing transaction rule
  • `delete-rule` - Delete a transaction rule
Prompts
  • `financial-insights` - Generate insights and recommendations based on your financial data
  • `budget-review` - Analyze your budget compliance and suggest adjustments

Installation

Prerequisites
Remote access

Pull the latest docker image:

docker pull sstefanov/actual-mcp:latest
Local setup
  1. Clone the repository:
git clone https://github.com/s-stefanov/actual-mcp.git

cd actual-mcp

  1. Install dependencies:
npm install
  1. Build the server:
npm run build
  1. Build the local docker image (optional):
docker build -t <local-image-name> .
  1. Configure environment variables (optional):
# Path to your Actual Budget data directory (default: ~/.actual)

export ACTUAL_DATA_DIR="/path/to/your/actual/data"

If using a remote Actual server

export ACTUAL_SERVER_URL="https://your-actual-server.com" export ACTUAL_PASSWORD="your-password"

Specific budget to use (optional)

export ACTUAL_BUDGET_SYNC_ID="your-budget-id"

How long downloaded data stays fresh before the server re-syncs, in ms

(default: 60000). Use 0 to sync before every call, or -1 to never sync.

export ACTUAL_SYNC_TTL_MS="60000"

Optional: separate encryption budget password

If your Actual setup requires a different password to unlock the local/encrypted budget data than the server authentication password, you can set ACTUAL_BUDGET_ENCRYPTION_PASSWORD in addition to ACTUAL_PASSWORD.

# If server auth and encryption/unlock use different passwords

export ACTUAL_BUDGET_ENCRYPTION_PASSWORD="your-encryption-password"

Optional: OpenID servers (session token auth)

If your Actual server uses OpenID login (for example Google) with ACTUAL_OPENID_ENFORCE=true, password login is disabled, so ACTUAL_PASSWORD can't be used. Instead, sign in to Actual in a browser and pass the resulting session token. It takes precedence over ACTUAL_PASSWORD.

export ACTUAL_SERVER_URL="https://your-actual-server.com"

export ACTUAL_SESSION_TOKEN="your-session-token"

To find the token, sign in to Actual in your browser, open DevTools, and go to Application → IndexedDB → actual → asyncStorage. The value of the user-token key is your session token. It's a UUID (e.g. 3f2b8c1e-9a4d-4e7b-8c2a-1d5e6f7a8b9c), not a long JWT-style bearer token. You can check it with curl -H "X-ACTUAL-TOKEN: " https://your-actual-server.com/account/validate, which should return "validated": true. Treat it like a password: it grants full access to your budgets. How long it stays valid depends on the server's ACTUAL_TOKEN_EXPIRATION setting. If it is invalid or expired, the MCP server still starts, but tool calls fail with Authentication failed: invalid or expired session token, because the server connects to Actual on the first request (--test-resources reports the error immediately). Sign in again, replace the token, and restart the MCP server.

Connection lifecycle

The server keeps one shared Actual connection for its entire lifetime and serializes budget operations through it. Downloaded data is re-synced when it exceeds the ACTUAL_SYNC_TTL_MS freshness window. In both stdio and HTTP modes, SIGINT and SIGTERM drain in-flight work before the server shuts down. Actual is no longer initialized and shut down for each tool call.

Report semantics
  • Balances and balance histories are capped as of today; future-dated transactions are excluded, and the current-month balance-history row is partial.
  • Closed on-budget accounts remain included in historical reports; closed off-budget accounts stay excluded by default.
  • Monthly income follows Actual's income-group metadata. Refunds net against expenses, zero-activity months count in averages, and uncategorized transfer pairs are skipped.
  • The former Investments bucket is removed from monthly summaries.

Usage with Claude Desktop

To use this server with Claude Desktop, add it to your Claude configuration:

On MacOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add the following to your configuration...

a. Using Node.js (npx version):
{

"mcpServers": { "actualBudget": { "command": "npx", "args": ["-y", "actual-mcp", "--enable-write"], "env": { "ACTUAL_DATA_DIR": "path/to/your/data", "ACTUAL_PASSWORD": "your-password", "ACTUAL_SERVER_URL": "http://your-actual-server.com", "ACTUAL_BUDGET_SYNC_ID": "your-budget-id" } } } }

a. Using Node.js (local only):
{

"mcpServers": { "actualBudget": { "command": "node", "args": ["/path/to/your/clone/build/index.js", "--enable-write"], "env": { "ACTUAL_DATA_DIR": "path/to/your/data", "ACTUAL_PASSWORD": "your-password", "ACTUAL_SERVER_URL": "http://your-actual-server.com", "ACTUAL_BUDGET_SYNC_ID": "your-budget-id" } } } }

b. Using Docker (local or remote images):
{

"mcpServers": { "actualBudget": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/path/to/your/data:/data", "-e", "ACTUAL_PASSWORD=your-password", "-e", "ACTUAL_SERVER_URL=https://your-actual-server.com", "-e", "ACTUAL_BUDGET_SYNC_ID=your-budget-id", "sstefanov/actual-mcp:latest", "--enable-write" ] } } }

After saving the configuration, restart Claude Desktop.

💡 ACTUAL_DATA_DIR is optional if you're using ACTUAL_SERVER_URL.

💡 Use --enable-write to enable write-access tools.

Running an SSE Server

To expose the server over a port using Docker:

docker run -i --rm \

-p 3000:3000 \ -v "/path/to/your/data:/data" \ -e ACTUAL_PASSWORD="your-password" \ -e ACTUAL_SERVER_URL="http://your-actual-server.com" \ -e ACTUAL_BUDGET_SYNC_ID="your-budget-id" \ -e BEARER_TOKEN="your-bearer-token" \ sstefanov/actual-mcp:latest \ --sse --enable-write --enable-bearer

⚠️ Important: When using --enable-bearer, the BEARER_TOKEN environment variable must be set.

🔒 This is highly recommended if you're exposing your server via a public URL.

Example Queries

Once connected, you can ask Claude questions like:

  • "What's my current account balance?"
  • "Show me my spending by category last month"
  • "How much did I spend on groceries in January?"
  • "What's my savings rate over the past 3 months?"
  • "Which categories am I overspending on this month?"
  • "How has my net worth changed over the past year?"
  • "Which payees do I spend the most with?"
  • "Is my grocery spending trending up or down?"
  • "Analyze my budget and suggest areas to improve"
  • "What custom reports do I have?"
  • "Add a net worth widget to my Spending Plan dashboard"
  • "Rearrange my dashboard so the cash flow card is full width at the top"

Usage with Codex CLI

Example Codex configuration:

In ~/.codex/config.toml:

[mcp_servers.actual-budget]

url = "http://localhost:3000"

Point Codex at the same port you pass to npm start -- --sse --port .

Development

For development with auto-rebuild:

npm run watch
Testing the connection to Actual

To verify the server can connect to your Actual Budget data:

node build/index.js --test-resources
Debugging

Since MCP servers communicate over stdio, debugging can be challenging. You can use the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js
E2E validation gate

The end-to-end test suite (vitest.e2e.config.ts) spins up a real Actual B

Solo se muestra el principio; lee el resto en el repo