YNAB MCP 서버

ynab-mcp-서버

mcp-framework로 구축된 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP는 https://ynab.com 에서 YNAB 예산 설정과 상호 작용할 수 있는 도구를 제공합니다.

AI가 이 도구와 상호 작용하려면 YNAB에서 개인 액세스 토큰( https://api.ynab.com/#personal-access-tokens )을 받아야 합니다. 이 MCP 서버를 클라이언트에 추가할 때 개인 액세스 토큰을 YNAB_API_TOKEN으로 제공해야 합니다. 이 토큰은 LLM으로 직접 전송되지 않습니다. YNAB API에서 사용할 수 있도록 환경 변수에 비공개로 저장됩니다.

설정

환경 변수 지정:

YNAB_API_TOKEN(필수)
YNAB_BUDGET_ID(선택 사항)

목표

이 프로젝트의 목표는 AI 대화를 통해 YNAB 예산과 소통하는 것입니다. 몇 가지 주요 워크플로를 활성화하고자 합니다.

워크플로:

첫 번째 설정

사용 가능한 예산 중에서 예산을 선택하라는 메시지가 표시됩니다. 다른 도구를 먼저 사용하려고 하면 기본 예산을 설정하라는 메시지가 표시됩니다.
- 필요한 도구: ListBudgets

초과 지출 카테고리 관리

새로운 거래 추가

거래 승인

월 총 지출과 총 수입을 확인하세요

카테고리 목표에 따라 자금을 할당할 준비가 된 자동 분배

현재 상태

사용 가능한 도구:

ListBudgets - 계정에서 사용 가능한 예산을 나열합니다.
BudgetSummary - 자금이 부족한 범주와 예산이 부족한 계정에 대한 요약을 제공합니다.
GetUnapprovedTransactions - 승인되지 않은 모든 거래 검색
CreateTransaction - 지정된 예산 및 계정에 대한 거래를 생성합니다.
- 예시 프롬프트: Add a transaction to my Ally account for $3.98 I spent at REI today
- 먼저 GetBudget을 호출해야 계정 ID를 알 수 있습니다.
ApproveTransaction - YNAB 예산에서 기존 거래를 승인합니다.
- 승인하려면 거래 ID가 필요합니다.
- GetUnapprovedTransactions와 함께 사용하여 보류 중인 거래를 승인할 수 있습니다.
- 승인되지 않은 거래에 대해 전화한 후 approve the transaction for $6.95 on the Apple Card 요청합니다.

1번의 전화로 여러 거래를 승인할 수 있습니다
updateCategory 도구 - 또는 Zod 및 MCP 프레임워크에서 선택적 매개변수가 제대로 작동하도록 할 수 있는 경우 updateTransaction이 더 일반적인 도구입니다.
MCP 프레임워크에서 벗어나 모델 컨텍스트 프로토콜 SDK를 직접 사용할 수 있나요?

빠른 시작

지엑스피1

프로젝트 구조

ynab-mcp-server/
├── src/
│   ├── tools/        # MCP Tools
│   └── index.ts      # Server entry point
├── .cursor/
│   └── rules/        # Cursor AI rules for code generation
├── package.json
└── tsconfig.json

구성 요소 추가

YNAB SDK는 사용 가능한 API 엔드포인트를 설명합니다: https://github.com/ynab/ynab-sdk-js .

YNAB 오픈 API 사양은 https://api.ynab.com/papi/open\_api\_spec.yaml 에 있습니다. 이 사양은 AI가 새로운 도구를 생성하도록 유도하는 데 사용할 수 있습니다. 커서 에이전트에 대한 프롬프트 예시:

create a new tool based on the readme and this openapi doc: https://api.ynab.com/papi/open_api_spec.yaml

The new tool should get the details for a single budget

CLI를 사용하여 더 많은 도구를 추가할 수 있습니다.

# Add a new tool
mcp add tool my-tool

# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

도구 개발

도구 구조의 예:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describes what your tool does";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

npm에 게시하기

package.json을 업데이트하세요:
- name 이 고유하고 npm 명명 규칙을 따르는지 확인하세요.
- 적절한 version 설정하세요
- description , author , license 등을 추가합니다.
- 올바른 항목 파일에 대한 bin 포인트를 확인하세요.
로컬로 빌드하고 테스트하세요.
npm run build npm link ynab-mcp-server # Test your CLI locally
npm에 로그인합니다(필요한 경우 계정을 만듭니다):
npm login
패키지를 게시하세요:
npm publish

게시 후 사용자는 이를 Claude 데스크톱 클라이언트에 추가하거나(아래 참조) npx로 실행할 수 있습니다.

Claude Desktop과 함께 사용

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 YNAB Budget Assistant를 자동으로 설치하려면:

npx -y @smithery/cli install @calebl/ynab-mcp-server --client claude

지역 개발

Claude Desktop 구성 파일에 다음 구성을 추가하세요.

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ynab-mcp-server": {
      "command": "node",
      "args":["/absolute/path/to/ynab-mcp-server/dist/index.js"]
    }
  }
}

출판 후

Claude Desktop 구성 파일에 다음 구성을 추가하세요.

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ynab-mcp-server": {
      "command": "npx",
      "args": ["ynab-mcp-server"]
    }
  }
}

다른 MCP 클라이언트

사용 가능한 다른 클라이언트는 https://modelcontextprotocol.io/clients에서 확인하세요.

빌딩 및 테스트

도구를 변경하세요
npm run build 실행하여 컴파일합니다.
서버는 시작 시 자동으로 도구를 로드합니다.

자세히 알아보기

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

ynab_list_budgets

YNAB(You Need A Budget) 데이터와 AI 기반 상호작용을 가능하게 하는 모델 컨텍스트 프로토콜 서버로, 사용자는 대화형 인터페이스를 통해 예산을 쿼리할 수 있습니다.

Related MCP Servers

MCP YNAB Server
klauern
A
security
F
license
A
quality
An MCP server that allows users to interact with YNAB data, enabling access to account balances, transactions, and the creation of new transactions through the Model Context Protocol.
Last updated -
10
1
Python
MCP YNAB Server
Meh-S-Eze
-
security
F
license
-
quality
Provides access to YNAB (You Need A Budget) functionality through the Model Context Protocol, allowing users to view account balances, access transaction data, and create new transactions.
Last updated -
Python
Meeting BaaS MCP Server
Meeting-Baas
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants to manage meeting data, including creating meeting bots, searching transcripts, and organizing calendar events.
Last updated -
15
TypeScript
MIT License
ynab-mcp
EthanKang1
-
security
A
license
-
quality
A Model Context Protocol (MCP) server for interacting with YNAB (You Need A Budget). Provides tools for accessing budget data through MCP-enabled clients like Claude Desktop.
Last updated -
Python
MIT License

View all related MCP servers

YNAB MCP Server