keep-mcp

MCP server for Google Keep

keep-mcp

How to use

Add the MCP server to your MCP servers:

"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" } } }

Add your credentials:

GOOGLE_EMAIL: Your Google account email address
GOOGLE_MASTER_TOKEN: Your Google account master token

Check https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token and https://github.com/simon-weber/gpsoauth?tab=readme-ov-file#alternative-flow for more information.

Related MCP server: Google Drive MCP Server

Features

find: Search for notes based on a query string
create_note: Create a new note with title and text (automatically adds keep-mcp label)
update_note: Update a note's title and text
delete_note: Mark a note for deletion

By default, all destructive and modification operations are restricted to notes that have were created by the MCP server (i.e. have the keep-mcp label). Set UNSAFE_MODE to true to bypass this restriction.

"env": { ... "UNSAFE_MODE": "true" }

Publishing

To publish a new version to PyPI:

Update the version in pyproject.toml
Build the package:
pipx run build
Upload to PyPI:
pipx run twine upload --repository pypi dist/*

Troubleshooting

If you get "DeviceManagementRequiredOrSyncDisabled" check https://admin.google.com/ac/devices/settings/general and turn "Turn off mobile management (Unmanaged)"