Skip to content
MCP server

Google Keep MCP

Read and create Google Keep notes from an assistant (Workspace accounts only)

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI, self-hosted
Runs
Locally
Version
26.11.14
Listing updated
3 days ago

About Google Keep MCP

Google Keep MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Google offers the Keep API to Workspace organisations only, so this server will not read notes in a personal account. Setup also needs a Workspace administrator, because access comes through a service account with domain-wide delegation and an impersonated user.

Two read tools list notes with text or checklist items and fetch one note with its attachment list. Changes go through a single keep_admin tool that can create a note or checklist and delete one; deletion only runs with confirm: true. The API cannot edit an existing note, and attachment contents are not read.

It installs as a VS Code extension that registers with eight agents, or runs from npm on Node.js 22 or newer. The page describes it as independent of Google.

Install

Run in a terminal

claude mcp add google-keep-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-keep-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-keep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-keep-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-keep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-keep-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-keep-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-keep-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-keep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-keep-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-keep-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-keep-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Keep scopes.
  • GOOGLE_KEEP_MCP_SUBJECTWorkspace user a domain-wide-delegated service account acts as.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

keep_list_notes
Lists notes with title, text or checklist items and last change time.
keep_get_note
Gets one note with its list of attachments.
keep_admin
Creates or deletes notes through named actions; delete needs confirm.

What it does

Note listing
Lists notes with title, text or checklist items and update time.
Single note fetch
Returns one note with its attachment list.
Create notes
Adds a note or checklist through keep_admin.
Confirmed deletes
delete_note does nothing without confirm: true.
Filtered queries
Filters by update time or trashed state, up to 100 per page.

Good for

  • Ask which checklist items are still open
  • Find a note you half remember
  • Turn meeting notes into repository docs
  • Create a release checklist

Pricing

Open source

Free and MIT licensed

Prices change. Check renzojohnson.com before you buy.

Google Keep MCP FAQ

Does it work with a personal Gmail account?

No; Google restricts the Keep API to Workspace.

Can it edit an existing note?

No; it can create and delete notes only.

Is it free?

Yes, MIT licensed.

Is Google Keep MCP free?

Yes. Google Keep MCP is open source, so you can use and self-host it for free.

How do I add Google Keep MCP to Claude Code?

Run this command in your terminal: claude mcp add google-keep-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-keep-mcp

What are the best alternatives to Google Keep MCP?

The closest alternatives to Google Keep MCP are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Google Keep MCP

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools