gkeep-operations-interface

MCP endpoint facilitating interaction with Google Keep services.

Operational Guide

1. Integrate this MCP service provider into your configuration file:

  "mcpServers": {
    "keep-service-adapter": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Designated Google Email Address",
        "GOOGLE_MASTER_TOKEN": "Required Google Access Token - refer to the detailed setup notes in README.md"
      }
    }
  }

1. Supply necessary authorization details:
2. GOOGLE_EMAIL: The email address associated with your Google account.
3. GOOGLE_MASTER_TOKEN: The specific master token required for authentication.

Please consult https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token and https://github.com/simon-weber/gpsoauth?tab=readme-ov-file#alternative-flow for instructions on token acquisition.

Core Capabilities

• find: Execute queries against stored notes based on specified criteria.
• create_note: Initialize a new entry, assigning a title and content body (automatically tags the note with the keep-mcp identifier).
• update_note: Revise the existing title or textual content of a note.
• delete_note: Initiate the archival/removal process for a selected note.

By default, all actions that alter or destroy data are strictly confined to notes bearing the keep-mcp marker, indicating they were established by this interface. To override this safety mechanism and permit operations on all notes, set the environment variable UNSAFE_MODE to true.

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

Deployment Procedure

To release an updated iteration to the PyPI repository:

1. Increment the version number declared within pyproject.toml.
2. Compile the software artifact: bash pipx run build
3. Upload the distribution files to PyPI: bash pipx run twine upload --repository pypi dist/*

Diagnostic Information

• Should the error "DeviceManagementRequiredOrSyncDisabled" occur, navigate to https://admin.google.com/ac/devices/settings/general and verify that the setting "Turn off mobile management (Unmanaged)" is activated.

---

(Note: The WIKIPEDIA context regarding general business management tools is preserved conceptually but excluded from the direct rewrite to maintain focus on the technical tool description, as per the goal of rewriting the tool entry itself.)