M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
K

Keep MCP Server

Community
MCP server for Google Keep, enabling note management and automation.
How to install ↓ Compare GitHub source repository ↗
Category
Cloud Storage #6 of 15
Stars
★ 105 Popular
Transport
stdio (local process)
Runtime
Python 3.11 · Prebuilt binary
Credentials
API key / credential required
License
MIT
Last commit
Tools
23

Static review · not runListed 2026-08-07

FMRS 60/100 · C · Weakest Reliability 10/20 — Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

  • Personal knowledge management
  • Note automation
  • AI workflows tightly integrated with Google Keep

Not for

  • Environments requiring high security without sharing email tokens
  • Users without a Google account
  • Advanced features requiring full official API support (e.g., audio notes)

Required permissions

  • Requires access to Google account email and master token for authentication
  • Can read/write notes, labels, collaborators, and media; scope depends on token permissions and UNSAFE_MODE

Risks and side effects

  • Master token leakage could lead to unauthorized access to account data
  • Default safety mechanism (keep-mcp label) may limit modification of non-server notes; enabling UNSAFE_MODE increases risk
  • Destructive operations like deletion may be irreversible; use with caution

Setup

Before you start

Runtime：Python 3.11 · Prebuilt binary

GOOGLE_EMAIL required Your Google account email address.
GOOGLE_MASTER_TOKEN requiredsecret Your Google master token; see gkeepapi docs (gkeepapi.readthedocs.io) and gpsoauth's alternative-flow instructions.
Other optional settings (1)
UNSAFE_MODE optional Set to true to bypass the restriction of only modifying notes with the keep-mcp label; keep false by default.
  1. Add the MCP server configuration to your client (see JSON example above).
  2. Set environment variables GOOGLE_EMAIL and GOOGLE_MASTER_TOKEN; see docs for obtaining them.
  3. Optionally set UNSAFE_MODE=true to modify notes not created by the server.
claude_desktop_config.json 
{
  "mcpServers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add keep-mcp-pipx -e 'GOOGLE_EMAIL=Your Google Email' -e 'GOOGLE_MASTER_TOKEN=Your Google Master Token - see README.md' -- pipx run keep-mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

Restart the MCP client and confirm tools like find, get_note, and create_note appear in the tool list; then run a find prompt — returning Google Keep notes proves the connection.

Troubleshooting

  1. If you get DeviceManagementRequiredOrSyncDisabled, check Google Admin settings to turn off mobile management
  2. Ensure GOOGLE_EMAIL and GOOGLE_MASTER_TOKEN are correctly set and not expired
  3. Check MCP client configuration for correct command and arguments

Things to try

Once connected, you can ask your AI assistant things like:

  • Search for all notes with the TODO label
  • Create a checklist note titled 'Shopping list'
  • Change my note's color to yellow and pin it
  • List media files for the note with ID xxx

Tools 23

find read-only
Search notes with optional filters for labels, colors, pinned, archived, and trashed
get_note read-only
Get a single note by ID
create_note writes
Create a new note with title and text (automatically adds keep-mcp label)
create_list writes
Create a checklist note
update_note writes
Update a note's title and text
add_list_item writes
Add an item to a checklist note
update_list_item writes
Update checklist item text and checked state
delete_list_item destructive
Delete a checklist item
Show 15 more tools
set_note_color writes
Set a note color
pin_note writes
Pin or unpin a note
archive_note writes
Archive or unarchive a note
trash_note destructive
Move a note to trash
restore_note writes
Restore a trashed/deleted note
delete_note destructive
Mark a note for deletion
list_labels read-only
List labels
create_label writes
Create a label
delete_label destructive
Delete a label
add_label_to_note writes
Add a label to a note
remove_label_from_note writes
Remove a label from a note
list_note_collaborators read-only
List collaborator emails for a note
add_note_collaborator writes
Add a collaborator email to a note
remove_note_collaborator writes
Remove a collaborator email from a note
list_note_media read-only
List media blobs for a note (with media links)

Use cases

Automate management of Google Keep notes
Quickly search and organize notes via AI assistant
Integrate note collaboration workflows

Supported clients

Claude Desktop
Cursor
Cline
Codex
Goose

Listed from the project's documentation, not tested by this site.

Overview

keep-mcp is an MCP server that allows AI assistants to access and manage Google Keep notes. It supports searching, creating, updating, deleting notes, as well as managing labels, collaborators, and media. By default, modification operations are restricted to notes created by the server (tagged with keep-mcp), which can be bypassed by setting UNSAFE_MODE=true.

Similar servers

Compare with other MCP servers

Source revision 567dfd92b6dd Data synced 2026-10-12 Read the FMRS scoring method