google-keep-mcp
Exposes Google Keep notes as MCP tools, letting an agent list, read, create, and manage notes in a Google Keep account via the unofficial gkeepapi client.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-keep-mcp list my recent Google Keep notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
google-keep-mcp
An MCP server that exposes Google Keep notes as tools, so an MCP client (Claude Code, Claude Desktop, etc.) can work with them.
Google Keep has no official public API. This project talks to Keep through
gkeepapi, an unofficial client — expect
it to break whenever Google changes the private endpoints.
Tools
Tool | Does |
| Search the account's notes. Filters: |
| Move a note to the trash by id, or delete it outright with |
Both tools sync with Google on every call, so results reflect the account's current state and deletions are pushed immediately.
Related MCP server: NotesKeep MCP Server
Requirements
Python 3.13+
Setup
uv sync
cp .env.example .env # then fill in your credentialsCredentials
gkeepapi authenticates with a Google master token, not your password.
Obtain one once (see the gkeepapi docs),
then set GOOGLE_KEEP_EMAIL and GOOGLE_KEEP_MASTER_TOKEN — see
.env.example.
A master token grants full access to the account. Treat it like a password: keep it out of version control and out of shell history.
Running
The server speaks MCP over stdio:
uv run google-keep-mcpRegister it with a client — for Claude Code:
claude mcp add google-keep -- uv run --directory /path/to/google-keep-mcp google-keep-mcpCredentials are read from the process environment, falling back to a .env
file in the working directory. To pass them through the client config instead,
add --env GOOGLE_KEEP_EMAIL=... --env GOOGLE_KEEP_MASTER_TOKEN=... to the
command above. Sign-in is deferred until the first tool call, so a
misconfigured server still starts and reports the problem in the tool result.
Development
uv run ruff check . # lint
uv run ruff format . # format
uv run pytest # testsLicense
MIT — see LICENSE.
Available Tools
2 toolsdelete_noteDelete noteADestructiveIdempotent
Move a Google Keep note to the trash, or delete it permanently.
Inputs: note_id (required), permanent. Returns: Confirmation that a note was removed.
list_notesList notesARead-only
Search the Google Keep account and return the matching notes.
Inputs: limit, query, labels, pinned, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
list_notes and delete_note target completely distinct actions with no overlap. An agent can easily choose the right tool based on the operation needed.
Both tools follow a consistent verb_noun pattern (list_notes, delete_note). The naming is predictable and uniform.
With only 2 tools, the server feels thin for a Google Keep integration. The count is borderline but not absurdly small.
The surface lacks essential operations like creating, updating, or fetching a single note by ID. Only list and delete are supported, leaving significant workflow gaps.
Maintenance
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Google Keep MCP, read and edit your notes, lists, labels and collaborators. Connect with your Google
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Give Claude a second brain for your notes, tasks and contacts. OAuth; it can't delete anything.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables interaction with Google Keep notes through an MCP server, allowing users to search, create, update, and delete notes via natural language commands.23532 PyPI114MIT
- AlicenseCqualityDmaintenanceEnables users to manage their notes on NotesKeep directly through Claude Code or other MCP clients. It supports creating, updating, and organizing both text and checklist notes using natural language commands.1415 npm1MIT
- FlicenseBqualityDmaintenanceA Model Context Protocol server that connects Google Keep to Claude, enabling full note management capabilities including search, CRUD, checklists, labels, and more.20-
- AlicenseAqualityCmaintenanceEnables Claude or Cursor to read Google Keep notes and checklists, add items, and check or uncheck them via MCP over HTTP with OAuth.71MIT