Google Keep
List, create, and delete Keep notes and manage collaborators on Google Workspace Enterprise accounts.
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
- 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/keepin Admin Console → Security → Access and data control → API controls
- Open Integrations → Google Keep in stackgate.ai.
- Click Activate, then Connect Google Keep.
- 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 examplegoogle-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.