Home / MCP / Keep MCP Server

Keep MCP Server

MCP server for Google Keep

Python

60stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "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",
                "UNSAFE_MODE": "true (optional)"
            }
        }
    }
}

You can connect Google Keep to an MCP client using the keep-mcp server. It lets you search, create, update, and delete notes from Keep through MCP operations, with safety controls that restrict destructive actions to notes created by the MCP server.

How to use

Use the keep-mcp server with your MCP client to interact with Google Keep. You can search for notes, create new notes with a title and text, update existing notes, and mark notes for deletion. The server automatically applies a keep-mcp label to notes it creates, and destructive actions are restricted to notes that have that label unless you enable unsafe mode.

How to install

Prerequisites: Python 3.x and your preferred package runner. You will also need pipx to run the MCP server package via a local Python toolchain.

1) Install Python 3.x from your system package manager or official installers.

2) Install pipx if it is not already installed, so you can run Python-based MCP servers easily.

3) Add the MCP server to your MCP servers configuration using the command snippet below. This enables you to run keep-mcp through pipx.

"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"
    }
  }
}

Additional setup details

Set up credentials for Google Keep access before starting the server. You will need:

- GOOGLE_EMAIL: Your Google account email address

- GOOGLE_MASTER_TOKEN: Your Google account master token

For more details on obtaining tokens, follow the recommended flows for master tokens and auth. The process involves going through Google Keep’s authentication steps to obtain a usable master token.

Optional safety note: By default, destructive and modification operations are restricted to notes created by the MCP server (those with the keep-mcp label). To bypass this restriction, enable UNSAFE_MODE in the environment.

"env": {
  ...
  "UNSAFE_MODE": "true"
}

Available tools

find

Search for notes based on a query string within Google Keep.

create_note

Create a new note with a title and text; the note is labeled with keep-mcp to indicate provenance.

update_note

Update the title and text of an existing note.

delete_note

Mark a note for deletion (soft delete) from Google Keep.