wlater-McpServer

What it is

An MCP server over Google Keep, built on the gkeepapi library. It reads the whole note collection with filtering, and writes back changes, but with a deliberate safety design: every modification is previewed for approval before it reaches Keep, deletion is not exposed at all, and credentials live in your operating system's keyring rather than a config file.

What you get

• Search and read every note, filtered by label, colour, pinned state or archived state, including notes with images, drawings and audio attached
• Create notes and todo lists, and check items off a shopping or task list
• Update note content, titles and colours, pin notes, archive them, and sort a list alphabetically
• Organise with labels, and share notes with collaborators
• A preview step on every change — nothing syncs to Keep until you approve it, and nothing happens automatically
• No delete: notes can only be trashed and untrashed, with permanent deletion left to the Keep app itself

Requirements

A Google account and its master token, obtained either by running wlater-setup token with Selenium and a webdriver installed — a browser opens, you sign in, and the token is extracted — or by fetching it manually through the gpsoauth route and running wlater-setup. pip install wlater-mcp installs the package (version 0.2.0); the client entry runs python -m wlater_mcp.server over stdio. Credentials are stored in the system keyring — Windows Credential Locker, macOS Keychain or the Linux Secret Service. If the connection fails after a restart, re-run wlater-setup and decline reconfiguration; that step exists so credentials are not left open on every start.

Setup effort

One command plus credentials — pip install wlater-mcp, then supply credentials

Requires

python on PATH

Where it runs

All 3 documented clients run the server on your machine.