YNAB Toolkit
spenserhale/ynab-toolkit
SDK + CLI + MCP para automação e integração com YNAB
Ver no GitHubSDK, 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-toolkit1 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
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
| Package | Description |
|---|---|
@ynab-toolkit/sdk | Core SDK with types, API client, and business logic |
@ynab-toolkit/cli | Command-line interface (Stricli) |
@ynab-toolkit/mcp | MCP 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
- Add types to
packages/sdk/src/types.ts - Add the client method to
packages/sdk/src/client.ts - Add a CLI command in
packages/cli/src/commands/ - 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.