Overview
What is keep-mcp?
keep-mcp is a Model Context Protocol (MCP) server that provides a structured interface to Google Keep. It enables AI assistants and MCP clients to search, create, update, and manage Google Keep notes, lists, labels, collaborators, and media attachments using the user’s Google credentials.
How to use keep-mcp?
Add keep‑mcp to your MCP client’s configuration with the command pipx run keep-mcp and environment variables GOOGLE_EMAIL and GOOGLE_MASTER_TOKEN. Optionally set UNSAFE_MODE to true to allow modification of notes not created by the server. You can also run a local checkout via make start or uv run -m server.
Key features of keep-mcp
- Search notes with filters for labels, colors, pinned/archived/trashed state
- Create and update notes, checklist notes, and list items
- Pin, archive, trash, restore, or delete notes
- Set note color from twelve predefined values
- Add, remove, and list labels and collaborators
- List media blobs attached to a note
- Safety mode restricts destructive operations to server‑created notes
Use cases of keep-mcp
- An AI assistant can search a user’s Google Keep notes and retrieve content by ID
- Automate note creation, checklist management, and note state changes from a chatbot
- Sync or back up Keep notes by querying and updating them programmatically
- Manage labels and collaborators across multiple notes in a workspace
FAQ from keep-mcp
What is the keep‑mcp label?
It’s automatically added to every note created by the server. By default, operations that modify or delete notes are restricted to notes that have this label.
How do I bypass the keep‑mcp label restriction?
Set the environment variable UNSAFE_MODE to true. This allows destructive operations on any note in the account, not just those created by the server.
How do I obtain a Google Master Token?
Follow the instructions at the gkeepapi documentation: https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token or the gpsoauth alternative flow.
What does “DeviceManagementRequiredOrSyncDisabled” mean?
Your Google Workspace admin may have mobile management enabled. Check https://admin.google.com/ac/devices/settings/general and turn “Turn off mobile management (Unmanaged)” on.
What runtime dependencies does keep‑mcp require?
Python 3.11, pipx, uv, and make are used for installation and local development. The server communicates with Google Keep APIs using a master token.
