gastar-menos-mcp

Servidor MCP (Model Context Protocol) para o Gastar Menos. Gerencie carteiras e transacoes usando linguagem natural no seu assistente de IA.

Pre-requisitos

• Node.js >= 18
• Conta no Gastar Menos
• Token MCP (gere em gastarmenos.com.br/mcp)

Configuracao

Adicione o bloco abaixo no arquivo de configuracao do seu cliente MCP:

{
  "mcpServers": {
    "gastar-menos": {
      "command": "npx",
      "args": ["-y", "gastar-menos-mcp@latest"],
      "env": {
        "MCP_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Onde fica o arquivo de configuracao

| Cliente | Arquivo | |---|---| | Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json | | Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json | | Claude Code | ~/.claude.json | | Cursor | .cursor/mcp.json na raiz do projeto |

Apos salvar, reinicie o cliente.

Tools disponiveis (16)

Carteiras (6)

| Tool | Descricao | |---|---| | list_wallets | Lista todas as carteiras | | get_wallet | Busca carteira por ID | | get_wallet_balance | Consulta saldo (com data limite opcional) | | create_wallet | Cria nova carteira | | update_wallet | Atualiza carteira existente | | delete_wallet | Exclui carteira |

Transacoes (5)

| Tool | Descricao | |---|---| | list_transactions | Lista transacoes de um mes | | get_transaction | Busca transacao por ID | | create_transaction | Cria transacao (suporta parcelas e recorrencia) | | update_transaction | Atualiza transacao (com escopo: atual, futuras ou todas) | | delete_transaction | Exclui transacao (com escopo: atual, futuras ou todas) |

Compartilhamento (5)

| Tool | Descricao | |---|---| | share_wallet | Compartilha carteira com outro usuario por email | | list_wallet_shares | Lista usuarios com acesso a uma carteira | | update_wallet_share_permission | Altera permissao (VIEW ou EDIT) | | revoke_wallet_share | Revoga o acesso de um usuario | | leave_shared_wallet | Sai de uma carteira compartilhada com voce |

Exemplos de uso

Depois de configurar, voce pode pedir ao seu assistente:

• "Qual o saldo da minha carteira principal?"
• "Lista minhas transacoes de fevereiro"
• "Cria uma despesa de R$ 50 no cartao de credito, parcelada em 3x"
• "Cria uma mensalidade de R$ 100 para academia"
• "Compartilha minha carteira com [email protected] com permissao de edicao"

Convencoes

• Valores monetarios sao em centavos (10000 = R$ 100,00)
• Datas no formato YYYY-MM-DD
• Autenticacao via token MCP (gerado em gastarmenos.com.br/mcp)

Variavel de ambiente

| Variavel | Obrigatoria | Descricao | |---|---|---| | MCP_TOKEN | Sim | Token gerado na pagina /mcp do Gastar Menos | | BACKEND_URL | Nao | URL da API (padrao: https://api.gastarmenos.com.br) |

Licenca

Privado.