Skip to main content
Glama
deenesjakoruzh
justmytwospence

ynab-mcp

by justmytwospence
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

ynab-mcp

Un servidor MCP (Model Context Protocol) que expone la API completa de YNAB, permitiendo a los LLM leer y gestionar tu presupuesto mediante lenguaje natural. Proporciona herramientas para operaciones CRUD, recursos para el contexto del presupuesto ambiental y prompts para flujos de trabajo financieros guiados.

Requisitos

Related MCP server: YNAB MCP Server

Instalación

npm install -g ynab-mcp

O instálalo desde el código fuente:

git clone https://github.com/justmytwospence/ynab-mcp.git
cd ynab-mcp
npm install
npm run build
npm install -g .

Configuración

Establece tu token de API de YNAB como una variable de entorno:

export YNAB_API_TOKEN="your-token-here"

Genera un token en YNAB > Account Settings > Developer Settings.

Claude Code

claude mcp add ynab-mcp ynab-mcp -e YNAB_API_TOKEN=your-token-here

Claude Desktop

Añádelo a tu claude_desktop_config.json:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "ynab-mcp",
      "env": {
        "YNAB_API_TOKEN": "your-token-here"
      }
    }
  }
}

Herramientas

50 herramientas que cubren la API completa de YNAB. Todas las cantidades monetarias utilizan el formato de milinidades de YNAB (ej. $12.34 = 12340).

Conocimiento de límites de tasa

La API de YNAB limita el uso a 200 solicitudes por hora (ventana deslizante) por token. El servidor rastrea cada llamada y expone:

  • Herramienta get_api_usage / recurso ynab://api-usage — verificación explícita bajo demanda (0 llamadas a la API).

  • Advertencias automáticas añadidas a cada resultado de herramienta una vez que el uso es alto:

    • [RATE LIMIT WARNING] con 50 o menos restantes

    • [RATE LIMIT CRITICAL] con 20 o menos restantes

    • [RATE LIMIT REACHED] con 0 restantes

La descripción de cada herramienta incluye su coste de llamada a la API entre corchetes (ej. [1 API call]). Prefiere herramientas masivas (create_transactions, update_transactions) sobre bucles de herramientas de una sola llamada.

Usuario

Herramienta

Descripción

get_user

Obtener información del usuario autenticado

Presupuestos

Herramienta

Descripción

list_budgets

Listar todos los presupuestos con información opcional de cuenta

get_budget

Obtener el detalle completo de un presupuesto incluyendo todas las entidades

get_budget_settings

Obtener la configuración de fecha y formato de moneda

Cuentas

Herramienta

Descripción

list_accounts

Listar todas las cuentas con saldos y tipos

get_account

Obtener detalles de una sola cuenta

create_account

Crear una nueva cuenta

Categorías

Herramienta

Descripción

list_categories

Listar todas las categorías agrupadas por grupo de categorías

get_category

Obtener detalles de una sola categoría

create_category

Crear una nueva categoría

update_category

Actualizar el nombre, nota o meta de una categoría

get_month_category

Obtener el presupuesto de una categoría para un mes específico

update_month_category

Actualizar el importe presupuestado para una categoría en un mes

create_category_group

Crear un nuevo grupo de categorías

update_category_group

Actualizar el nombre de un grupo de categorías

Transacciones

Herramienta

Descripción

list_transactions

Listar transacciones con filtros opcionales

get_transaction

Obtener detalles de una sola transacción

create_transaction

Crear una nueva transacción

create_transactions

Crear múltiples transacciones en lote

update_transaction

Actualizar una transacción existente

update_transactions

Actualizar múltiples transacciones en masa

delete_transaction

Eliminar una transacción

import_transactions

Importar desde instituciones financieras vinculadas

list_account_transactions

Listar transacciones para una cuenta específica

list_category_transactions

Listar transacciones para una categoría específica

list_payee_transactions

Listar transacciones para un beneficiario específico

list_month_transactions

Listar transacciones para un mes específico

Transacciones programadas

Herramienta

Descripción

list_scheduled_transactions

Listar todas las transacciones programadas/recurrentes

get_scheduled_transaction

Obtener detalles de una transacción programada

create_scheduled_transaction

Crear una nueva transacción programada

update_scheduled_transaction

Actualizar una transacción programada

delete_scheduled_transaction

Eliminar una transacción programada

Beneficiarios

Herramienta

Descripción

list_payees

Listar todos los beneficiarios

get_payee

Obtener detalles de un solo beneficiario

update_payee

Actualizar el nombre de un beneficiario

Ubicaciones de beneficiarios

Herramienta

Descripción

list_payee_locations

Listar todas las ubicaciones GPS de beneficiarios

get_payee_location

Obtener una sola ubicación de beneficiario

get_payee_locations_for_payee

Obtener todas las ubicaciones para un beneficiario específico

Meses

Herramienta

Descripción

list_months

Listar todos los meses presupuestarios con resúmenes

get_month

Obtener información detallada del mes con saldos de categorías

Movimientos de dinero

Herramienta

Descripción

list_money_movements

Listar todos los movimientos de dinero

get_month_money_movements

Obtener movimientos de dinero para un mes específico

list_money_movement_groups

Listar todos los grupos de movimientos de dinero

get_month_money_movement_groups

Obtener grupos de movimientos de dinero para un mes específico

Flujos de trabajo

Herramienta

Descripción

merge_category

Fusionar una categoría de origen en una de destino, moviendo todas las transacciones e importes presupuestados

delete_category

Limpiar una categoría para su eliminación: recategoriza todo el historial a un reemplazo y pone a cero los presupuestos (la eliminación final es manual en la aplicación YNAB — limitación de la API)

audit_credit_card_payments

Auditar los saldos de las categorías de pago de tarjetas de crédito frente a los saldos de las tarjetas, con corrección automática opcional

Recursos

Los recursos proporcionan datos presupuestarios estructurados que los clientes pueden incorporar al contexto sin una llamada de herramienta. Los recursos de plantilla utilizan parámetros URI (ej. {budget_id}).

Recurso

URI

Descripción

Coste API

Uso de API

ynab://api-usage

Estado actual del límite de tasa: llamadas usadas, restantes, reinicio de ventana

0

Resumen de presupuesto

ynab://budgets/{budget_id}/summary

Visión general del presupuesto con cuentas, saldos y grupos de categorías

1

Lista de cuentas

ynab://budgets/{budget_id}/accounts

Todas las cuentas con tipo, saldo, saldos compensados/no compensados

1

Categorías mensuales

ynab://budgets/{budget_id}/months/{month}/categories

Todas las categorías para un mes con presupuesto, actividad y saldo

1

Prompts

Los prompts son plantillas de flujo de trabajo guiadas que los usuarios pueden invocar para realizar tareas presupuestarias comunes. Indican al LLM qué herramientas llamar y cómo interpretar los resultados.

Prompt

Argumentos

Descripción

monthly-review

budget_id, month

Revisar un mes presupuestario: categorías con sobregasto, variaciones de gasto, metas subfinanciadas, discrepancias de tarjetas de crédito

transaction-audit

budget_id, account_id, since_date

Auditar transacciones por categorías no asignadas, no aprobadas, duplicados y cantidades inusuales

budget-setup-guide

budget_id

Guía paso a paso: cuentas, categorías, metas, transacciones programadas, asignación de fondos

spending-analysis

budget_id, month

Desglose de categorías, presupuesto vs. real, principales beneficiarios, ingresos vs. gastos

credit-card-audit

budget_id, since_month?

Auditar saldos de categorías de pago de tarjetas de crédito con flujo de prueba primero y confirmación antes de aplicar

Desarrollo

npm run dev    # Watch mode with tsx
npm run build  # Compile TypeScript
npm start      # Run compiled server

Licencia

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • YNAB MCP Server

    ntdef
    A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that enables interaction with You Need A Budget (YNAB) via their API, allowing users to manage budgets, accounts, categories, and transactions through natural language.
    2
    MIT

  • YNAB MCP Server

    chrisguidry
    F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides Large Language Models with access to YNAB (You Need A Budget) budgets, allowing them to fetch budget data including accounts, categories, and category groups.
    6

  • YNAB MCP Server

    WGDevelopment
    A
    license
    A
    quality
    D
    maintenance
    A minimal and auditable MCP server that enables local AI assistants to read and manage YNAB budget data. It supports operations like listing accounts, tracking transactions, and moving money between categories while maintaining user privacy.
    9
    MIT

  • YNAB MCP Server

    rgarcia
    A
    license
    B
    quality
    C
    maintenance
    Exposes YNAB API endpoints as MCP tools, allowing AI assistants to manage budgets, accounts, transactions, and more through natural language.
    44
    90
    MIT

View all related MCP servers

Related MCP Connectors

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • ynab-mcp-server

    Hosted remote MCP server for YNAB on Cloudflare Workers with OAuth

  • Backtest360

    MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/justmytwospence/ynab-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server