Monarch Money

Acesse e gerencie seus dados financeiros e operações do Monarch Money.

GitHub

Experimente este MCPPatrocinado

Documentação

Monarch Money MCP Server

Arquivado em favor do Monarch Money Connector agora oficialmente suportado

Um servidor MCP (Model Context Protocol) que fornece acesso aos dados financeiros e operações do Monarch Money.

Recursos

Gerenciamento de Contas: Liste e recupere informações de contas
Operações de Transações: Obtenha transações com filtros por intervalo de datas, contas e categorias
Análise de Orçamento: Acesse dados de orçamento e insights de gastos
Gerenciamento de Categorias: Liste e gerencie categorias de transações
Acompanhamento de Metas: Acesse metas financeiras e progresso
Acompanhamento de Patrimônio Líquido: Recupere instantâneos de patrimônio líquido ao longo do tempo

Instalação

Clone ou baixe este servidor MCP
Instale as dependências:
```
cd /path/to/monarch-money-mcp
uv sync
```

Configuração

Adicione o servidor ao seu arquivo de configuração .mcp.json:

{
  "mcpServers": {
    "monarch-money": {
      "command": "/path/to/uv",
      "args": [
        "--directory", 
        "/path/to/monarch-money-mcp",
        "run",
        "python",
        "server.py"
      ],
      "env": {
        "MONARCH_EMAIL": "your-email@example.com",
        "MONARCH_PASSWORD": "your-password",
        "MONARCH_MFA_SECRET": "your-mfa-secret-key"
      }
    }
  }
}

Notas Importantes:

Substitua /path/to/uv pelo caminho completo para o executável uv (encontre-o com which uv)
Substitua /path/to/monarch-money-mcp pelo caminho absoluto para este diretório do servidor
Use caminhos absolutos, não caminhos relativos

Obtendo Seu Segredo MFA

Vá para as configurações do Monarch Money e ative a 2FA
Quando o código QR for exibido, procure a opção "Não consegue escanear?" ou "Inserir manualmente"
Copie a chave secreta (será uma string como T5SPVJIBRNPNNINFSH5W7RFVF2XYADYX)
Use isso como seu MONARCH_MFA_SECRET

Ferramentas Disponíveis

`get_accounts`

Liste todas as contas com seus saldos e detalhes.

`get_transactions`

Obtenha transações com filtros opcionais:

start_date: Filtre transações a partir desta data (YYYY-MM-DD)
end_date: Filtre transações até esta data (YYYY-MM-DD)
account_ids: Lista de IDs de contas para filtrar
category_ids: Lista de IDs de categorias para filtrar
limit: Número máximo de transações a retornar

`get_categories`

Liste todas as categorias de transações.

`get_budgets`

Obtenha informações de orçamento e análise de gastos.

`get_goals`

Liste metas financeiras e seu progresso.

`get_cashflow`

Obtenha dados de fluxo de caixa para análise de receitas e despesas.

`get_investments`

Obtenha detalhes e desempenho de contas de investimento.

`get_net_worth`

Obtenha instantâneos de patrimônio líquido ao longo do tempo.

Exemplos de Uso

Informações Básicas da Conta

Use the get_accounts tool to see all my accounts and their current balances.

Análise de Transações

Get all transactions from January 2024 using get_transactions with start_date "2024-01-01" and end_date "2024-01-31".

Acompanhamento de Orçamento

Show me my current budget status using the get_budgets tool.

Gerenciamento de Sessão

O servidor gerencia automaticamente as sessões de autenticação:

As sessões são armazenadas em cache em um diretório .mm para logins subsequentes mais rápidos
O cache de sessão é criado e gerenciado automaticamente
Use MONARCH_FORCE_LOGIN=true na seção env para forçar um novo login se necessário

Solução de Problemas

Problemas com MFA

Certifique-se de que seu segredo MFA está correto e formatado adequadamente
Tente definir MONARCH_FORCE_LOGIN=true na seção env do seu .mcp.json
Verifique se o horário do seu sistema está preciso (necessário para TOTP)

Problemas de Conexão

Verifique se seu e-mail e senha estão corretos em .mcp.json
Verifique sua conexão com a internet
Tente executar o servidor diretamente para ver mensagens de erro detalhadas:
```
uv run server.py
```

Problemas de Sessão

Exclua o diretório .mm para limpar as sessões em cache
Defina MONARCH_FORCE_LOGIN=true na seção env do seu .mcp.json temporariamente

Créditos

Servidor MCP

Autor: Taurus Colvin (@colvint)
Descrição: Wrapper de servidor MCP (Model Context Protocol) para Monarch Money

Biblioteca Python MonarchMoney

Autor: hammem (@hammem)
Repositório: https://github.com/hammem/monarchmoney
Licença: Licença MIT
Descrição: A biblioteca Python subjacente que fornece acesso à API do Monarch Money

Este servidor MCP encapsula a biblioteca Python monarchmoney para fornecer integração perfeita com assistentes de IA através do Model Context Protocol.

Notas de Segurança

Mantenha suas credenciais seguras no seu arquivo .mcp.json
O segredo MFA fornece acesso total à sua conta - trate-o como uma senha
Os arquivos de sessão no diretório .mm contêm tokens de autenticação - mantenha-os seguros
Considere restringir o acesso ao seu arquivo .mcp.json, pois ele contém credenciais sensíveis