Skip to main content
Glama
deenesjakoruzh
justmytwospence

ynab-mcp

by justmytwospence
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

ynab-mcp

Ein MCP-Server (Model Context Protocol), der die vollständige YNAB-API bereitstellt und es LLMs ermöglicht, Ihr Budget mittels natürlicher Sprache zu lesen und zu verwalten. Er bietet Tools für CRUD-Operationen, Ressourcen für den Kontext des aktuellen Budgets sowie Prompts für geführte Finanz-Workflows.

Anforderungen

Related MCP server: YNAB MCP Server

Installation

npm install -g ynab-mcp

Oder aus dem Quellcode installieren:

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

Konfiguration

Setzen Sie Ihr YNAB-API-Token als Umgebungsvariable:

export YNAB_API_TOKEN="your-token-here"

Generieren Sie ein Token unter YNAB > Account Settings > Developer Settings.

Claude Code

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

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Tools

50 Tools, die die vollständige YNAB-API abdecken. Alle Geldbeträge verwenden das Milliunits-Format von YNAB (z. B. $12.34 = 12340).

Bewusstsein für Ratenbegrenzungen

Die YNAB-API begrenzt die Nutzung auf 200 Anfragen pro Stunde (gleitendes Fenster) pro Token. Der Server verfolgt jeden Aufruf und stellt Folgendes bereit:

  • get_api_usage Tool / ynab://api-usage Ressource — explizite Prüfung auf Abruf (0 API-Aufrufe).

  • Automatische Warnungen, die an jedes Tool-Ergebnis angehängt werden, sobald die Nutzung hoch ist:

    • [RATE LIMIT WARNING] bei 50 oder weniger verbleibenden Aufrufen

    • [RATE LIMIT CRITICAL] bei 20 oder weniger verbleibenden Aufrufen

    • [RATE LIMIT REACHED] bei 0 verbleibenden Aufrufen

Die Beschreibung jedes Tools enthält die Kosten in API-Aufrufen in Klammern (z. B. [1 API call]). Bevorzugen Sie Bulk-Tools (create_transactions, update_transactions) gegenüber Schleifen von Einzelaufruf-Tools.

Benutzer

Tool

Beschreibung

get_user

Authentifizierte Benutzerinformationen abrufen

Budgets

Tool

Beschreibung

list_budgets

Alle Budgets mit optionalen Kontoinformationen auflisten

get_budget

Vollständige Details eines Budgets inklusive aller Entitäten abrufen

get_budget_settings

Datums- und Währungsformat-Einstellungen abrufen

Konten

Tool

Beschreibung

list_accounts

Alle Konten mit Salden und Typen auflisten

get_account

Details für ein einzelnes Konto abrufen

create_account

Ein neues Konto erstellen

Kategorien

Tool

Beschreibung

list_categories

Alle Kategorien gruppiert nach Kategoriegruppe auflisten

get_category

Details für eine einzelne Kategorie abrufen

create_category

Eine neue Kategorie erstellen

update_category

Name, Notiz oder Ziel einer Kategorie aktualisieren

get_month_category

Budget einer Kategorie für einen bestimmten Monat abrufen

update_month_category

Budgetierten Betrag für eine Kategorie in einem Monat aktualisieren

create_category_group

Eine neue Kategoriegruppe erstellen

update_category_group

Name einer Kategoriegruppe aktualisieren

Transaktionen

Tool

Beschreibung

list_transactions

Transaktionen mit optionalen Filtern auflisten

get_transaction

Details für eine einzelne Transaktion abrufen

create_transaction

Eine neue Transaktion erstellen

create_transactions

Mehrere Transaktionen stapelweise erstellen

update_transaction

Eine bestehende Transaktion aktualisieren

update_transactions

Mehrere Transaktionen in einem Rutsch aktualisieren

delete_transaction

Eine Transaktion löschen

import_transactions

Von verknüpften Finanzinstituten importieren

list_account_transactions

Transaktionen für ein bestimmtes Konto auflisten

list_category_transactions

Transaktionen für eine bestimmte Kategorie auflisten

list_payee_transactions

Transaktionen für einen bestimmten Zahlungsempfänger auflisten

list_month_transactions

Transaktionen für einen bestimmten Monat auflisten

Geplante Transaktionen

Tool

Beschreibung

list_scheduled_transactions

Alle geplanten/wiederkehrenden Transaktionen auflisten

get_scheduled_transaction

Details für eine geplante Transaktion abrufen

create_scheduled_transaction

Eine neue geplante Transaktion erstellen

update_scheduled_transaction

Eine geplante Transaktion aktualisieren

delete_scheduled_transaction

Eine geplante Transaktion löschen

Zahlungsempfänger

Tool

Beschreibung

list_payees

Alle Zahlungsempfänger auflisten

get_payee

Details für einen einzelnen Zahlungsempfänger abrufen

update_payee

Name eines Zahlungsempfängers aktualisieren

Zahlungsempfänger-Standorte

Tool

Beschreibung

list_payee_locations

Alle GPS-Standorte von Zahlungsempfängern auflisten

get_payee_location

Einen einzelnen Standort eines Zahlungsempfängers abrufen

get_payee_locations_for_payee

Alle Standorte für einen bestimmten Zahlungsempfänger abrufen

Monate

Tool

Beschreibung

list_months

Alle Budgetmonate mit Zusammenfassungen auflisten

get_month

Detaillierte Monatsinformationen mit Kategoriensalden abrufen

Geldverschiebungen

Tool

Beschreibung

list_money_movements

Alle Geldverschiebungen auflisten

get_month_money_movements

Geldverschiebungen für einen bestimmten Monat abrufen

list_money_movement_groups

Alle Geldverschiebungsgruppen auflisten

get_month_money_movement_groups

Geldverschiebungsgruppen für einen bestimmten Monat abrufen

Workflows

Tool

Beschreibung

merge_category

Eine Quellkategorie in eine Zielkategorie zusammenführen und alle Transaktionen sowie budgetierten Beträge verschieben

delete_category

Eine Kategorie für die Löschung bereinigen: Kategorisiert die gesamte Historie auf einen Ersatz um und setzt Budgets auf Null (endgültiges Löschen erfolgt manuell in der YNAB-App — API-Einschränkung)

audit_credit_card_payments

Salden der Kreditkartenzahlungskategorien gegen Kartensalden prüfen, mit optionaler automatischer Korrektur

Ressourcen

Ressourcen bieten strukturierte Budgetdaten, die Clients ohne Tool-Aufruf in den Kontext laden können. Vorlagen-Ressourcen verwenden URI-Parameter (z. B. {budget_id}).

Ressource

URI

Beschreibung

API-Kosten

API-Nutzung

ynab://api-usage

Aktueller Status der Ratenbegrenzung: genutzte Aufrufe, verbleibend, Fenster-Reset

0

Budget-Zusammenfassung

ynab://budgets/{budget_id}/summary

Budget-Überblick mit Konten, Salden und Kategoriegruppen

1

Kontenliste

ynab://budgets/{budget_id}/accounts

Alle Konten mit Typ, Saldo, ausgeglichenen/nicht ausgeglichenen Salden

1

Monatliche Kategorien

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

Alle Kategorien für einen Monat mit Budget, Aktivität und Saldo

1

Prompts

Prompts sind geführte Workflow-Vorlagen, die Benutzer aufrufen können, um gängige Budgetierungsaufgaben zu durchlaufen. Sie weisen das LLM an, welche Tools aufgerufen werden sollen und wie die Ergebnisse zu interpretieren sind.

Prompt

Argumente

Beschreibung

monthly-review

budget_id, month

Überprüfung eines Budgetmonats: überzogene Kategorien, Ausgabenabweichungen, unterfinanzierte Ziele, Kreditkarten-Diskrepanzen

transaction-audit

budget_id, account_id, since_date

Prüfung von Transaktionen auf nicht kategorisierte, nicht genehmigte, doppelte und ungewöhnliche Beträge

budget-setup-guide

budget_id

Geführte Anleitung: Konten, Kategorien, Ziele, geplante Transaktionen, Mittelzuweisung

spending-analysis

budget_id, month

Kategorienaufschlüsselung, Budget vs. Ist, Top-Zahlungsempfänger, Einnahmen vs. Ausgaben

credit-card-audit

budget_id, since_month?

Prüfung der Salden von Kreditkartenzahlungskategorien mit Trockenlauf-zuerst-Modus und Bestätigungs-vor-Anwendung-Workflow

Entwicklung

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

Lizenz

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