convez.ai
MCP ServerFinanceiroIntermediário
spenserhale

YNAB Toolkit

spenserhale/ynab-toolkit

SDK + CLI + MCP para automação e integração com YNAB

Ver no GitHub
InicialPluginScore · de 0 a 100

SDK, CLI e MCP server para integração com YNAB (You Need a Budget). Monorepo que oferece cliente de API, interface de linha de comando e servidor MCP para AI assistants, permitindo automação e consulta de dados financeiros pessoais.

Instalação

$npx convez-ai spenserhale/ynab-toolkit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 semana
Versão
v0.2.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automatizar operações orçamentárias via CLI
  • Integrar dados do YNAB com agentes IA (Claude, Cursor)
  • Consultar categorias, contas e transações via API programática
  • Sincronizar dados financeiros com ferramentas externas

Veredito

Ferramenta sólida para quem trabalha com YNAB e precisa de integração programática. Arquitetura limpa em monorepo (SDK → CLI/MCP) facilita manutenção. Ideal para agentes IA orquestrarem operações financeiras pessoais ou para desenvolvedores construírem automações custom.

README

A tradução para o português deste README ainda está na fila.

Ynab Toolkit

SDK, CLI, and MCP server for YNAB (You Need a Budget)

A monorepo containing the SDK, CLI, and MCP server for the Ynab API.

Packages

PackageDescription
@ynab-toolkit/sdkCore SDK with types, API client, and business logic
@ynab-toolkit/cliCommand-line interface (Stricli)
@ynab-toolkit/mcpMCP server for AI assistants (FastMCP)

Getting Started

# Install dependencies
bun install

# Build all packages
bun run build

# Run the CLI
bun run dev:cli -- --help

# Run the MCP server (stdio mode for Claude Desktop)
bun run dev:mcp

Architecture

packages/sdk/     <-- Types, API client, business logic (foundation)
    ^       ^
    |       |
packages/cli/   packages/mcp/
    (Stricli)    (FastMCP)

Both the CLI and MCP server are thin wrappers over the SDK. If the REST API changes, you update the SDK and both consumers get the fix automatically.

Development

# Run tests across all packages
bun test

# Build a specific package
cd packages/sdk && bun run build

Adding a New API Operation

  1. Add types to packages/sdk/src/types.ts
  2. Add the client method to packages/sdk/src/client.ts
  3. Add a CLI command in packages/cli/src/commands/
  4. Add an MCP tool in packages/mcp/src/tools/

Agent Skills

This repo bundles a ynab-cli agent skill at .agents/skills/ynab-cli. It teaches AI coding agents (Claude Code, Cursor, etc.) how to drive the ynab CLI correctly — the command surface, milliunit amounts, budget IDs, dry-run/idempotency safety flags, and exit codes.

Add it to another project with the skills CLI:

npx skills add github.com/spenserhale/ynab-toolkit/.agents/skills/ynab-cli

Agents working in this repo pick it up automatically via the .agents/skills/ directory — no install step needed.

Ver o original no GitHub

Bom para

Relacionados