Google Keep
List, create, and delete Keep notes and manage collaborators on Google Workspace Enterprise accounts.
Example questions
Try asking your AI client
-
What Google Keep notes did I change in the last 2 days?
-
Did I ever jot down Jack's desk number in Keep?
-
Write a draft Keep note about the feature Amalie and I are shipping - do not create it yet.
-
Find the shopping list I shared with my partner.
-
Which Keep notes still have unchecked boxes?
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 local 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.