← Projects
Open source

mcp-google-keep

Read & write Google Keep notes from Claude — search, create, checklists, labels & colours

Features

  • Full note management — create text notes and checklists, update content, colour, and pinned/archived state in one call
  • Rich filtering — search notes by query text, label, colour, or pinned/archived/trashed status
  • Checklist tools — add, replace, sort, indent, and dedent list items without touching the whole note
  • Label management — create, rename, and delete labels; apply or remove them from any note
  • Collaboration — share notes with other Google accounts and revoke access by email
  • Secure credentials — one-time OAuth flow stores your master token in the macOS Keychain; no plaintext secrets

Install

uv tool install git+https://github.com/kud/mcp-google-keep
mcp-google-keep-setup
claude mcp add google-keep mcp-google-keep

mcp-google-keep-setup runs the one-time Google credential flow and stores your master token in the macOS Keychain.

Usage

Add the server to your MCP client config:

{
  "mcpServers": {
    "google-keep": {
      "command": "mcp-google-keep"
    }
  }
}

Available tools:

ToolDescription
list_notesList notes; filter by query, label, colour, pinned, archived, or trashed state
get_noteFetch a single note by ID
create_text_noteCreate a new text note
create_list_noteCreate a new checklist note
update_noteUpdate title, text, colour, pinned/archived state, or labels
delete_noteMove a note to trash (requires confirm=true)
restore_noteRestore a trashed note
add_list_itemAppend an item to a checklist
update_list_itemsReplace all items in a checklist
sort_list_itemsSort checklist items alphabetically
indent_list_itemNest a list item under a parent item
dedent_list_itemRemove indentation from a nested list item
list_labelsList all labels
create_labelCreate a new label
rename_labelRename an existing label
delete_labelDelete a label (requires confirm=true)
add_collaboratorShare a note with another user by email
remove_collaboratorRemove a collaborator from a note

Development

git clone https://github.com/kud/mcp-google-keep.git
cd mcp-google-keep
uv sync
uv run python server.py

Run the credential setup flow separately:

uv run python keep_setup.py

The server lives in server.py (FastMCP, all 18 tools); credential setup lives in keep_setup.py.