Best for
- Personal knowledge management
- Note automation
- AI workflows tightly integrated with Google Keep
K
Keep MCP Server
Community
MCP server for Google Keep, enabling note management and automation.
GitHub source repository ↗
60FMRS · C
keep-mcp is an MCP server that allows AI assistants to access and manage Google Keep notes. It supports searching, creating, updating, deleting notes, as well as managing labels, collaborators, and media. By default, modification operations are restricted to notes created by the server (tagged with keep-mcp), which can be bypassed by setting UNSAFE_MODE=true.
Tools
find
Search notes with optional filters for labels, colors, pinned, archived, and trashed
get_note
Get a single note by ID
create_note
Create a new note with title and text (automatically adds keep-mcp label)
create_list
Create a checklist note
update_note
Update a note's title and text
add_list_item
Add an item to a checklist note
update_list_item
Update checklist item text and checked state
delete_list_item
Delete a checklist item
set_note_color
Set a note color
pin_note
Pin or unpin a note
archive_note
Archive or unarchive a note
trash_note
Move a note to trash
restore_note
Restore a trashed/deleted note
delete_note
Mark a note for deletion
list_labels
List labels
create_label
Create a label
delete_label
Delete a label
add_label_to_note
Add a label to a note
remove_label_from_note
Remove a label from a note
list_note_collaborators
List collaborator emails for a note
add_note_collaborator
Add a collaborator email to a note
remove_note_collaborator
Remove a collaborator email from a note
list_note_media
List media blobs for a note (with media links)
Setup
- Add the MCP server configuration to your client (see JSON example above).
- Set environment variables GOOGLE_EMAIL and GOOGLE_MASTER_TOKEN; see docs for obtaining them.
- Optionally set UNSAFE_MODE=true to modify notes not created by the server.
claude_desktop_config.json
{
"mcpServers": {
"keep-mcp-pipx": {
"command": "pipx",
"args": [
"run",
"keep-mcp"
],
"env": {
"GOOGLE_EMAIL": "Your Google Email",
"GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
}
}
}
}
Fit and risk
Not for
- Environments requiring high security without sharing email tokens
- Users without a Google account
- Advanced features requiring full official API support (e.g., audio notes)
Required permissions
- Requires access to Google account email and master token for authentication
- Can read/write notes, labels, collaborators, and media; scope depends on token permissions and UNSAFE_MODE
Risks and side effects
- Master token leakage could lead to unauthorized access to account data
- Default safety mechanism (keep-mcp label) may limit modification of non-server notes; enabling UNSAFE_MODE increases risk
- Destructive operations like deletion may be irreversible; use with caution
Troubleshooting
- If you get DeviceManagementRequiredOrSyncDisabled, check Google Admin settings to turn off mobile management
- Ensure GOOGLE_EMAIL and GOOGLE_MASTER_TOKEN are correctly set and not expired
- Check MCP client configuration for correct command and arguments
Use cases
Automate management of Google Keep notes
Quickly search and organize notes via AI assistant
Integrate note collaboration workflows
Supported clients
Claude DesktopFull support
CursorFull support
ClineFull support
CodexFull support
GooseFull support