home / mcp / wl ater mcp server
Unofficial MCP server for Google Keep - AI-powered access to your todos, lists, and notes
Configuration
View docs{
"mcpServers": {
"briansbrian-wlater-mcpserver": {
"command": "python",
"args": [
"-m",
"wlater_mcp.server"
]
}
}
}You can connect your AI assistant to Google Keep and manage notes, lists, and labels through natural conversation. This MCP Server lets you authenticate once, run the local server, and then control Google Keep from your AI client with safe, preview-before-save changes.
You interact with the ML-powered Keep integration by asking your assistant to search, read, and manage your Google Keep notes. You can use natural language prompts like asking to show all pinned notes, check off items on a shopping list, create new notes or todo lists, and filter by labels or colors. Every change is previewed before it is saved, and you can inspect results before committing actions.
Practical usage patterns include: - 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
Prerequisites: you need Python and pip available on your system.
pip install wlater-mcpSetup has automated and manual options for authentication with Google Keep.
# Automated setup with Selenium
pip install selenium
wlater-setup token
```
```bash
# Manual setup
wlater-setup
```${"code_block_end":""}Configure your MCP client to run the wlater MCP server locally. Two common environments are supported.
{
"servers": {
"wlater": {
"command": "python",
"args": ["-m", "wlater_mcp.server"]
}
}
}If you’re using other MCP clients (for example Claude Desktop or KIRO), you can use this configuration as well. The structure is the same, just place the config under the mcpServers section in your client’s setup.
{
"mcpServers": {
"wlater": {
"command": "python",
"args": ["-m", "wlater_mcp.server"],
"disabled": false
}
}
}Credentials are stored in your system keyring (Windows Credential Locker, macOS Keychain, Linux Secret Service). Previewing changes before syncing helps prevent unintended edits, and there are no automatic modifications.
If you encounter issues, try these steps to recover.
Master token not found: run the setup again to generate or retrieve your token.
Authentication failed: tokens can expire; re-run setup to refresh.
Server not appearing: confirm the config file paths and restart your MCP client.
After startup, if the MCP connection in the IDE fails, run setup again to initialize the MCP. Choose option N and avoid reconfiguring to protect credentials.
If automated setup doesn’t work, ensure you have Selenium installed and a WebDriver available.
Only actions that interact with Google Keep are supported. For safety, there is no automatic deletion; you should use the Google Keep app to delete notes if needed.