Wlater

Connect your AI assistant to Google Keep. Search, read, and manage your notes and lists through natural conversation.

Installation

pip install wlater-mcp

Setup

Quick Setup (Automated)

For automated authentication with Selenium:

pip install selenium
wlater-setup token

A browser window will open—just log in to your Google account and the token will be extracted automatically.

Manual Setup

If you prefer manual setup or automated doesn't work:

wlater-setup

You'll need your master token. Get it from:

• gpsoauth Guide
• gkeepapi Documentation

Configuration

Add to your MCP client's config file:

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

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

For Claude Desktop,KIRO or other MCP clients:

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

Restart your AI assistant and you're ready!

Usage

Talk to your AI naturally:

• "Show me all my pinned notes"
• "What's on my shopping list?"
• "Find notes with images attached"
• "Check off 'buy milk' from my grocery list"
• "Create a note called 'Meeting Notes'"
• "Add 'call dentist' to my todo list"
• "Find notes labeled 'work'"
• "Make my important note red and pin it"
• "Sort my shopping list alphabetically"

All changes are previewed before being saved to Google Keep.

Features

What You Can Do:

• ✅ Search and read all your notes
• ✅ Filter by labels, colors, pins, and archived status
• ✅ View attached images, drawings, and audio
• ✅ Create new notes and todo lists
• ✅ Check off items on your shopping lists
• ✅ Update note content, titles, and colors
• ✅ Pin important notes and archive old ones
• ✅ Organize with labels
• ✅ Sort your lists alphabetically
• ✅ Share notes with collaborators

How It Keeps You Safe:

• 🔒 Your login credentials are stored securely in your system keyring
• 👀 Preview every change before it's saved
• 🚫 Can't delete notes ,Only Trash\Untrash (use Google Keep app for that)
• ⏸️ All changes wait for your approval—nothing happens automatically

Troubleshooting

"Master token not found"

wlater-setup

"Authentication failed"
Your token may have expired. Re-run setup.

Server not appearing
Check your config file paths and restart your MCP client.

After StartUP, the Mcp connection in IDE may fail Just run -

wlater-setup

This is to initialize the mcp, Then Opt "N" and do not reconfigure. This protects open access to your credentials in your machine on every start.

Automated method doesnt work Make sure you have installed: -Selenium -Webdriver (important)

Security

• Credentials stored in your system keyring (Windows Credential Locker, macOS Keychain, Linux Secret Service)
• Preview all changes before syncing
• No automatic modifications
• Delete operations not exposed

Credits

-This Mcp utilizes the gkeepapi by kiwiz

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

Links

• Python Package
• Report Issues
• Model Context Protocol

License

MIT License - See LICENSE for details