wlater MCP Server

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 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.

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

Links

• GitHub Repository
• Report Issues
• Model Context Protocol

License

MIT License - See LICENSE for details