YNAB

Servidor MCP YNAB

Um servidor Model Context Protocol (MCP) para interagir com o YNAB (You Need A Budget). Fornece ferramentas para acessar dados de orçamento por meio de clientes habilitados para MCP, como o Claude Desktop.

Configuração do Cliente MCP

Configuração Básica

Adicione isto à configuração do seu cliente MCP (por exemplo, cline_mcp_settings.json para o Claude Desktop):

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uvx",
      "args": ["run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuração Avançada

Se você estiver executando a partir de um diretório específico:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Depuração

Para depurar com o MCP Inspector:

1. Instale o inspector:

npm install -g @modelcontextprotocol/inspector

2. Atualize sua configuração para usar o inspector com uv:

{
  "mcpServers": {
    "ynab-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ynab-mcp", "run", "@modelcontextprotocol/inspector", "ynab-mcp"],
      "env": {
        "YNAB_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

O inspector fornece:

• Logs em tempo real de chamadas e respostas de ferramentas
• Inspeção de solicitações/respostas
• Validação de esquema de ferramentas
• Interface de teste interativa

Ferramentas Disponíveis

GetUser

Recupera informações sobre o usuário YNAB autenticado, incluindo ID do usuário e e-mail.

ListBudgets

Lista todos os orçamentos acessíveis ao usuário autenticado, incluindo IDs e nomes dos orçamentos.

GetBudget

Recupera informações detalhadas sobre um orçamento específico, incluindo transações, categorias e saldos. Suporta filtragem opcional por data e limite de transações.

Observação: Os valores monetários são retornados em milliunits (por exemplo, 1000 = R$ 1,00)

GetBudgetCategories

Recupera todas as categorias definidas no orçamento especificado, incluindo grupos de categorias, nomes e IDs.

GetBudgetSettings

Recupera as configurações do orçamento especificado, incluindo formato de moeda, formato de data e outras preferências.