Google Keep MCP

Google Keep MCP is a free MCP server that gives your AI agent two tools for Google Keep. Your agent can list your notes, with their text or checklist items, and open a single note. One condition matters before you install it: Google offers the Keep API to Google Workspace organizations only. It can also make changes, such as creating a note or a checklist, with a confirmation step for anything destructive. It is its own VS Code extension, it runs on your machine, and it uses your own Google account.

There is no server to host and no config file to edit. You install the extension, sign in to Google once, and the tools appear in every agent it finds: VS Code Copilot, Claude Code, Cursor, OpenAI Codex, Google Gemini, Windsurf, Continue.dev, and Cline.

What you can ask

  • “List my recent Keep notes”
  • “What is on my release checklist?”
  • “Find the note about the server migration”
  • “Which checklist items are still unticked?”
  • “Create a checklist for the release steps”
  • “Save these meeting notes to Keep”

The two Google Keep MCP tools

Tool What it does What you can pass
keep_list_notes List notes with title, text or checklist items, and the time they were last changed A filter, for example by update time or trashed state, and a page size up to 100
keep_get_note Get one note with its list of attachments The note name

The Google Keep admin tool

Changes go through one tool, keep_admin, with named actions.

Action What it does
create_note Create a note with text or a checklist
delete_note Delete a note (needs confirmation)

Destructive actions need explicit confirmation

delete_note only runs with confirm: true. Without it the server changes nothing and returns a warning, so the agent has to ask you first. Reading never needs it.

Three things people use it for

Working from a checklist

If your release steps or setup steps live in a Keep checklist, the agent can read it and follow it, and tell you which items are still open.

Finding the note you half remember

Ask for notes changed in a date range and let the agent pick out the one about a topic. It reads the text of each note.

Turning notes into something lasting

Quick notes tend to stay in Keep. Ask the agent to read a set of them and write them up as documentation in the repository.

Set it up in four steps

Keep is set up by a Google Workspace administrator, with a service account.

  1. In the Google Cloud Console, create a project or pick one, and enable the Google Keep API.
  2. Create a service account and download its JSON key.
  3. In the Workspace Admin console, give that service account domain-wide delegation for the Keep scope.
  4. In the extension’s wizard, choose Service Account and pick the key file. Then set googleKeepMcp.impersonateUser to the Workspace user whose notes the agent should read.

Using Google Keep MCP with Claude Code, Cursor and other agents

You do not add a server entry by hand. The extension writes the registration for each agent it finds: ~/.claude.json for Claude Code, ~/.cursor/mcp.json for Cursor, ~/.codex/config.toml for OpenAI Codex, ~/.gemini/settings.json for Gemini, and the matching files for Windsurf, Continue.dev, and Cline. VS Code Copilot picks it up through the VS Code API.

Open a new session in any of them and the tools are in the tool list. To limit which agents get them, switch the others off in VS Code settings under googleKeepMcp.agents. The command “Google Keep MCP: Remove from All Agents” takes every registration back out.

Limits

  • Google Workspace only. Personal Gmail accounts cannot use the Keep API.
  • Setup needs a Workspace administrator, because access is granted through domain-wide delegation.
  • Attachments are listed. Their contents are not read.
  • The Keep API cannot edit an existing note. The agent can create and delete notes.

Common questions

Is Google Keep MCP free?

Yes. The extension is free and MIT licensed.

Does it work with a personal Google account?

No. Google restricts the Keep API to Workspace organizations, so this extension cannot read notes in a personal account.

Why does it need an administrator?

Google grants Keep API access through domain-wide delegation, which only a Workspace administrator can configure.

Is this an official Google server?

No. It is an independent extension that calls the Google Keep API.

Does it work with Claude Code and Cursor?

Yes. Both are registered automatically, along with Copilot and five other agents.

Where does my data go?

Nowhere except Google. The MCP server runs on your own machine and calls Google’s API with your credentials. There is no telemetry, and the sign-in token is kept in VS Code’s encrypted secret storage.

Install it

Google Keep MCP is free and MIT licensed.

Related