Keep MCP

🚀 keep-mcp

The MCP server for Google Keep.

🚀 Quick Start

💻 Usage Examples

Basic Usage

1. Add the MCP server to your MCP server list:

  "mcpServers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email", // Your Google email address
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md" // Your Google master token (see README.md)
      }
    }
  }

2. Add your credentials:

• GOOGLE_EMAIL: Your Google account email address.
• GOOGLE_MASTER_TOKEN: Your Google account master token (see README.md for details).

For more details, please refer to https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token and https://github.com/simon-weber/gpsoauth?tab=readme-ov-file#alternative-flow.

✨ Features

• find: Search for notes based on a query string.
• create_note: Create a new note (title and content) and automatically add the keep-mcp tag.
• update_note: Update the title and content of a note.
• delete_note: Mark a note as deleted.

By default, all destructive and modification operations are limited to notes created by the MCP server (i.e., notes with the keep-mcp tag). Set UNSAFE_MODE to true to bypass this limitation.

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

📦 Installation

Publishing a new version to PyPI

1. Update the version number in pyproject.toml.
2. Build the package:

pipx run build

3. Upload to PyPI:

pipx run twine upload --repository pypi dist/*

📚 Documentation

Troubleshooting

• If you encounter the error message "DeviceManagementRequiredOrSyncDisabled", please check https://admin.google.com/ac/devices/settings/general and enable "Turn off mobile device management (unmanaged)".