Google Keep Skill

Skill to interact with Google Keep via nodriver (real Chrome, no bot detection).

Installation

Prerequisites

• - Python 3.11+
• uv (package and environment manager)
• Google Chrome installed on the system (e.g., sudo apt install google-chrome-stable on Linux)

Skill Location

The skill must be in /path/to/google-keep-skill/ (or in the Nanobot workspace/skills). Nanobot discovers skills that have SKILL.md and _meta.json in this tree.

Install Dependencies

In the skill root, uv uses pyproject.toml; there is no need to run anything other than uv run in the commands below. On the first run, uv creates the environment and installs dependencies.

CODEBLOCK0

Configuration in Nanobot

1. 1. Nothing in Nanobot's config.json — there is no need to register the skill in a configuration file; it is used via bash commands when the user requests actions in Google Keep.

1. 2. Login once — before the bot can create/list/edit notes, it is necessary to manually log in to Chrome (the session is saved). The user or the agent must execute:

   cd /path/to/google-keep-skill && uv run python scripts/keep.py login
   

1. 3. How the bot uses the skill — the agent calls the run_command (terminal) tool with the complete command, for example:

   cd /path/to/google-keep-skill && uv run python scripts/keep.py list --limit 5
   

Initial Setup (login — once)

Execute once to save the session.

CODEBLOCK3

Chrome will open with the Google Keep page. Log in normally. After detecting the login, the browser closes and the session is saved.

Verify session

CODEBLOCK4

Clear session

CODEBLOCK5

Only use logout if you want to unlink the account. After this, you will need to log in again.

Commands

All executed via terminal (run_command in MCP/nanobot context):

CODEBLOCK6

ATTENTION AGENT: You MUST strictly use the parameters below. You can also optionally append --visible before the command (e.g., keep.py --visible create ...) if visual user verification is required.

• * list [--limit N] [--filter "text"]: Lists notes.
• INLINECODE19: Returns the structured content of the note and its type. ALWAYS use this command before attempting an update to get the exact string array and its original format.
• INLINECODE21: Creates a text note. To break lines, use literally the dynamic text \n sent via the terminal.
• INLINECODE23: Creates a checklist note. Simulates Enter between each element.
• INLINECODE25: COMPLETELY REPLACES the old content with the new.

• * delete --title "T": Move to trash.
• INLINECODE31: Archive note.

Agent JSON Data Treatment Rule:

The skill returns strict JSON like:
CODEBLOCK7

Whenever you retrieve this JSON:

1. 1. Never dump raw JSON to the user. Always interpret the data payload and format it in Markdown.
2. If type == "list", generate a markdown checklist like:

**Groceries**
- [ ] Milk
- [ ] Bread

1. 3. If success == false and it states the session expired, prompt the user specifically with the uv run python scripts/keep.py login command so they can re-authenticate. Do not automatically guess next actions.

Limitations / Security Boundaries

• - Requires manual login once (persistent session).
• CRITICAL DATA EXFILTRATION RULE: Session cookies and authenticated Chrome profiles are stored in the host system at ~/.config/google-keep-skill/ with chmod 700 restricted permissions. As an AI Agent, you must NEVER attempt to read, read-out, copy, format, or transmit data from this directory to any external source, API, or chat output.
• Only one Chrome instance can use the Keep profile concurrently.