wlater-McpServer

Servidor MCP wlater

Conecte seu assistente de IA ao Google Keep. Pesquise, leia e gerencie suas notas e listas por meio de conversa natural.

Instalação

pip install wlater-mcp

Configuração

Configuração Rápida (Automatizada)

Para autenticação automatizada com Selenium:

pip install selenium
wlater-setup token

Uma janela do navegador será aberta—basta fazer login na sua conta do Google e o token será extraído automaticamente.

Configuração Manual

Se você preferir a configuração manual ou a automatizada não funcionar:

wlater-setup

Você precisará do seu token mestre. Obtenha-o em:

• Guia gpsoauth
• Documentação do gkeepapi

Configuração

Adicione ao arquivo de configuração do seu cliente MCP:

Para VS Code (.vscode/mcp.json):

{
  "servers": {
    "wlater": {
      "command": "python",
      "args": ["-m", "wlater_mcp.server"]
    }
  }
}

Para Claude Desktop, KIRO ou outros clientes MCP:

{
  "mcpServers": {
    "wlater": {
      "command": "python",
      "args": ["-m", "wlater_mcp.server"],
      "disabled": false
    }
  }
}

Reinicie seu assistente de IA e pronto!

Uso

Converse com sua IA naturalmente:

• "Mostre-me todas as minhas notas fixadas"
• "O que está na minha lista de compras?"
• "Encontre notas com imagens anexadas"
• "Marque 'comprar leite' na minha lista de compras"
• "Crie uma nota chamada 'Notas da Reunião'"
• "Adicione 'ligar para o dentista' à minha lista de tarefas"
• "Encontre notas com o rótulo 'trabalho'"
• "Deixe minha nota importante vermelha e fixe-a"
• "Ordene minha lista de compras em ordem alfabética"

Todas as alterações são pré-visualizadas antes de serem salvas no Google Keep.

Recursos

O que você pode fazer:

• ✅ Pesquisar e ler todas as suas notas
• ✅ Filtrar por rótulos, cores, fixações e status de arquivamento
• ✅ Visualizar imagens, desenhos e áudios anexados
• ✅ Criar novas notas e listas de tarefas
• ✅ Marcar itens nas suas listas de compras
• ✅ Atualizar conteúdo, títulos e cores das notas
• ✅ Fixar notas importantes e arquivar as antigas
• ✅ Organizar com rótulos
• ✅ Ordenar suas listas em ordem alfabética
• ✅ Compartilhar notas com colaboradores

Como ele mantém você seguro:

• 🔒 Suas credenciais de login são armazenadas com segurança no chaveiro do seu sistema
• 👀 Pré-visualize cada alteração antes de salvá-la
• 🚫 Não é possível excluir notas, apenas mover para a Lixeira/Recuperar (use o aplicativo Google Keep para isso)
• ⏸️ Todas as alterações aguardam sua aprovação—nada acontece automaticamente

Solução de Problemas

"Token mestre não encontrado"

wlater-setup

"Falha na autenticação"
Seu token pode ter expirado. Execute a configuração novamente.

Servidor não aparecendo
Verifique os caminhos do seu arquivo de configuração e reinicie o cliente MCP.

Após a inicialização, a conexão MCP no IDE pode falhar Basta executar -

wlater-setup

Isso é para inicializar o MCP. Em seguida, opte por "N" e não reconfigurar. Isso protege o acesso aberto às suas credenciais na sua máquina a cada inicialização.

O método automatizado não funciona Certifique-se de ter instalado: -Selenium -Webdriver (importante)

Segurança

• Credenciais armazenadas no chaveiro do seu sistema (Cofre de Credenciais do Windows, Chaveiro do macOS, Serviço Secreto do Linux)
• Pré-visualize todas as alterações antes de sincronizar
• Sem modificações automáticas
• Operações de exclusão não expostas

Créditos

-Este MCP utiliza o gkeepapi por kiwiz

• https://github.com/kiwiz/gkeepapi

Links

• Pacote Python
• Relatar Problemas
• Protocolo de Contexto do Modelo

Licença

Licença MIT - Consulte LICENÇA para obter detalhes