wlater MCP Server

# wlater MCP Server Connect your AI assistant to Google Keep. Search, read, and manage your notes and lists through natural conversation.  ## Installation ```bash pip install wlater-mcp ``` ## Setup ### Quick Setup (Automated) For automated authentication with Selenium: ```bash 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: ```bash wlater-setup ``` You'll need your master token. Get it from: - [gpsoauth Guide](https://github.com/rukins/gpsoauth-java/blob/b74ebca999d0f5bd38a2eafe3c0d50be552f6385/README.md#receiving-an-authentication-token) - [gkeepapi Documentation](https://gkeepapi.readthedocs.io/en/latest/#authenticating) ## Configuration Add to your MCP client's config file: **For VS Code** (`.vscode/mcp.json`): ```json { "servers": { "wlater": { "command": "python", "args": ["-m", "wlater_mcp.server"] } } } ``` **For Claude Desktop**,**KIRO** or other MCP clients: ```json { "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"** ```bash 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. **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](https://pypi.org/project/wlater-mcp) - [Report Issues](https://github.com/briansbrian/wlater-McpServer/issues) - [Model Context Protocol](https://modelcontextprotocol.io) ## License MIT License - See [LICENSE](LICENSE) for details