All integrations

Google Keep

List, create, and delete Keep notes and manage collaborators on Google Workspace Enterprise accounts.

OAuth Workspace Enterprise 7 tools

Overview

Connect Google Keep to give AI clients access to notes on Google Workspace Enterprise accounts — list, read, create, and delete notes, download attachments, and manage collaborator permissions.

This integration uses the official Google Keep REST API. Personal @gmail.com accounts are not supported on the cloud hub; a future desktop bridge may add personal-account support.

Prerequisites

  • A Google Workspace Enterprise account with Google Keep enabled
  • A stackgate.ai account
  • A Workspace super admin who can allowlist the stackgate.ai OAuth client for Keep scopes in the Google Admin Console

Getting credentials

  1. Ask your Workspace super admin to:
    • Enable the Google Keep API in the stackgate.ai Google Cloud project (or your organization's allowlisted project)
    • Allowlist the stackgate.ai OAuth client ID for https://www.googleapis.com/auth/keep in Admin Console → Security → Access and data control → API controls
  2. Open Integrations → Google Keep in stackgate.ai.
  3. Click Activate, then Connect Google Keep.
  4. Complete Google OAuth with your Workspace account.

If OAuth fails with an invalid scope error, the admin allowlisting step is not complete.

Using with AI clients

  • Dedicated endpoint: POST /mcp/google-keep
  • Private gateway: google-keep__* tools (for example google-keep__list_notes)

Typical workflow: list notes → get note details → create or delete notes → manage permissions when needed.

Troubleshooting

  • Invalid scope / OAuth error — your Workspace admin must allowlist Keep scopes for the stackgate.ai OAuth client.
  • 403 or access denied — confirm your account is on a Workspace Enterprise plan with Keep enabled.
  • Personal Gmail does not work — the official Keep API is enterprise-only on this cloud endpoint.
  • Cannot edit an existing note — the Keep API has no update endpoint; create a new note or delete the old one.

Available tools

  • list_notes

    List Google Keep notes for the connected Workspace account. Supports pagination and AIP filters such as trashed=true or createTime filters.

  • get_note

    Get a Google Keep note by resource name, including body, attachments metadata, and permissions.

  • create_note

    Create a new Google Keep note. The official API does not support updating existing notes.

  • delete_note

    Permanently delete a Google Keep note. Requires OWNER role on the note.

  • download_attachment

    Download a Google Keep note attachment. Returns metadata plus embedded binary content for files under 10 MB, or a resource_link for larger files.

  • batch_create_note_permissions

    Add WRITER collaborators to a Google Keep note. Only WRITER permissions can be created via the API.

  • batch_delete_note_permissions

    Remove collaborators from a Google Keep note. OWNER permissions cannot be deleted.

MCP endpoint: https://stackgate.ai/mcp/google-keep (HTTP) or via the private gateway.