Skip to main content
Glama
deenesjakoruzh
justmytwospence

ynab-mcp

by justmytwospence
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

ynab-mcp

전체 YNAB API를 노출하는 MCP(Model Context Protocol) 서버로, LLM이 자연어를 통해 예산을 읽고 관리할 수 있게 합니다. CRUD 작업을 위한 도구, 주변 예산 컨텍스트를 위한 리소스, 그리고 가이드가 포함된 재무 워크플로우를 위한 프롬프트를 제공합니다.

요구 사항

Related MCP server: YNAB MCP Server

설치

npm install -g ynab-mcp

또는 소스에서 설치:

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

구성

YNAB API 토큰을 환경 변수로 설정하세요:

export YNAB_API_TOKEN="your-token-here"

YNAB > 계정 설정 > 개발자 설정에서 토큰을 생성하세요.

Claude Code

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

Claude Desktop

claude_desktop_config.json에 추가하세요:

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

도구

전체 YNAB API를 다루는 50개의 도구입니다. 모든 금액은 YNAB의 밀리유닛(milliunits) 형식을 사용합니다 (예: $12.34 = 12340).

사용량 제한(Rate limit) 안내

YNAB API는 토큰당 시간당 200회 요청(슬라이딩 윈도우)으로 사용량을 제한합니다. 서버는 모든 호출을 추적하며 다음을 제공합니다:

  • get_api_usage 도구 / ynab://api-usage 리소스 — 명시적, 온디맨드 확인 (API 호출 0회).

  • 사용량이 많아지면 모든 도구 결과에 자동 경고가 추가됩니다:

    • 남은 횟수가 50회 이하일 때 [RATE LIMIT WARNING]

    • 남은 횟수가 20회 이하일 때 [RATE LIMIT CRITICAL]

    • 남은 횟수가 0회일 때 [RATE LIMIT REACHED]

각 도구의 설명에는 괄호 안에 API 호출 비용이 포함되어 있습니다 (예: [1 API call]). 단일 호출 도구를 반복하는 것보다 일괄 처리 도구(create_transactions, update_transactions)를 사용하는 것을 권장합니다.

사용자

도구

설명

get_user

인증된 사용자 정보 가져오기

예산

도구

설명

list_budgets

선택적 계좌 정보를 포함하여 모든 예산 나열

get_budget

모든 엔티티를 포함한 예산의 전체 세부 정보 가져오기

get_budget_settings

날짜 및 통화 형식 설정 가져오기

계좌

도구

설명

list_accounts

잔액 및 유형을 포함한 모든 계좌 나열

get_account

단일 계좌의 세부 정보 가져오기

create_account

새 계좌 생성

카테고리

도구

설명

list_categories

카테고리 그룹별로 모든 카테고리 나열

get_category

단일 카테고리의 세부 정보 가져오기

create_category

새 카테고리 생성

update_category

카테고리 이름, 메모 또는 목표 업데이트

get_month_category

특정 월의 카테고리 예산 가져오기

update_month_category

특정 월의 카테고리 예산 금액 업데이트

create_category_group

새 카테고리 그룹 생성

update_category_group

카테고리 그룹 이름 업데이트

거래

도구

설명

list_transactions

선택적 필터를 사용하여 거래 나열

get_transaction

단일 거래의 세부 정보 가져오기

create_transaction

새 거래 생성

create_transactions

여러 거래 일괄 생성

update_transaction

기존 거래 업데이트

update_transactions

여러 거래 일괄 업데이트

delete_transaction

거래 삭제

import_transactions

연결된 금융 기관에서 가져오기

list_account_transactions

특정 계좌의 거래 나열

list_category_transactions

특정 카테고리의 거래 나열

list_payee_transactions

특정 수취인의 거래 나열

list_month_transactions

특정 월의 거래 나열

예약된 거래

도구

설명

list_scheduled_transactions

모든 예약/반복 거래 나열

get_scheduled_transaction

예약된 거래의 세부 정보 가져오기

create_scheduled_transaction

새 예약 거래 생성

update_scheduled_transaction

예약된 거래 업데이트

delete_scheduled_transaction

예약된 거래 삭제

수취인

도구

설명

list_payees

모든 수취인 나열

get_payee

단일 수취인의 세부 정보 가져오기

update_payee

수취인 이름 업데이트

수취인 위치

도구

설명

list_payee_locations

모든 수취인 GPS 위치 나열

get_payee_location

단일 수취인 위치 가져오기

get_payee_locations_for_payee

특정 수취인의 모든 위치 가져오기

월

도구

설명

list_months

요약과 함께 모든 예산 월 나열

get_month

카테고리 잔액을 포함한 상세 월 정보 가져오기

자금 이동

도구

설명

list_money_movements

모든 자금 이동 나열

get_month_money_movements

특정 월의 자금 이동 가져오기

list_money_movement_groups

모든 자금 이동 그룹 나열

get_month_money_movement_groups

특정 월의 자금 이동 그룹 가져오기

워크플로우

도구

설명

merge_category

소스 카테고리를 대상 카테고리로 병합하여 모든 거래 및 예산 금액 이동

delete_category

삭제를 위해 카테고리 정리: 모든 기록을 대체 카테고리로 재분류하고 예산을 0으로 설정 (최종 삭제는 YNAB 앱에서 수동으로 수행 - API 제한)

audit_credit_card_payments

카드 잔액 대비 신용카드 결제 카테고리 잔액 감사 (자동 수정 옵션 포함)

리소스

리소스는 클라이언트가 도구 호출 없이 컨텍스트로 가져올 수 있는 구조화된 예산 데이터를 제공합니다. 템플릿 리소스는 URI 매개변수(예: {budget_id})를 사용합니다.

리소스

URI

설명

API 비용

API 사용량

ynab://api-usage

현재 사용량 제한 상태: 사용된 호출, 남은 횟수, 윈도우 초기화

0

예산 요약

ynab://budgets/{budget_id}/summary

계좌, 잔액, 카테고리 그룹을 포함한 예산 개요

1

계좌 목록

ynab://budgets/{budget_id}/accounts

유형, 잔액, 정리된/정리되지 않은 잔액을 포함한 모든 계좌

1

월별 카테고리

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

예산, 활동, 잔액을 포함한 해당 월의 모든 카테고리

1

프롬프트

프롬프트는 사용자가 일반적인 예산 관리 작업을 수행할 때 호출할 수 있는 가이드 워크플로우 템플릿입니다. LLM에게 어떤 도구를 호출하고 결과를 어떻게 해석해야 하는지 지시합니다.

프롬프트

인수

설명

monthly-review

budget_id, month

예산 월 검토: 초과 지출 카테고리, 지출 차이, 자금 부족 목표, 신용카드 불일치

transaction-audit

budget_id, account_id, since_date

미분류, 미승인, 중복 및 비정상적인 금액에 대한 거래 감사

budget-setup-guide

budget_id

가이드 워크스루: 계좌, 카테고리, 목표, 예약 거래, 자금 할당

spending-analysis

budget_id, month

카테고리 분석, 예산 대비 실제 지출, 상위 수취인, 수입 대비 지출

credit-card-audit

budget_id, since_month?

신용카드 결제 카테고리 잔액 감사 (사전 테스트 후 적용 확인 흐름)

개발

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

라이선스

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