add_label_to_note
Add a label to a note.
LABSCO SUMMARY
Full Keep, at the cost of a master token.
It covers Keep more completely than the official surface allows — checklists, collaborators, labels and colors are all here — because it drives the same private API the app uses. That is also the caveat: it needs a Google master token, which grants full account access, so decide you are comfortable holding one that way before you wire this up.
What it is
A server for Google Keep, driven through the gkeepapi library: 23 tools covering note and checklist CRUD, labels, colors, the note lifecycle, and per-note collaborators.
What you get
- find searches title and text (case-insensitive unless you ask otherwise) with filters for labels, colors and ISO 8601 date bounds, and get_note reads one by ID
- create_note makes a text note, and create_list makes a checklist from items shaped like {text, checked}, with add_list_item, update_list_item and delete_list_item to work the checklist afterwards
- update_note changes a note's properties, set_note_color takes one of Keep's named colors (DEFAULT, RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN, PURPLE, PINK, BROWN, GRAY), and pin_note pins or unpins
- The full lifecycle: archive_note, trash_note, restore_note and delete_note
- Labels handled end to end — list_labels, create_label, delete_label, and add_label_to_note / remove_label_from_note
- Collaborators managed per note: list_note_collaborators, add_note_collaborator and remove_note_collaborator by email
- list_note_media lists a note's media blobs with direct links where available
Requirements
Your Google account email in GOOGLE_EMAIL and a Google master token in GOOGLE_MASTER_TOKEN. Run it with uvx keep-mcp or pipx run keep-mcp. It connects through gkeepapi's unofficial private API, and the master token has full access to your account — the README is explicit that you should treat it like a password and never commit or share it.
Setup effort
One command plus credentials — uvx keep-mcp, then supply credentials
USE CASES
01
Capturing a note and filing it
Create the note, give it a color and a label so it lands where you will find it, and pin it if it needs to stay at the top.
02
Keeping a working checklist
Make a checklist, add items as they come up, and tick or edit them as you go rather than retyping the list.
03
Finding a note you half remember
Search by text with a label, color or date-range filter, then open the one that matches to read it in full.
04
Sharing a note with someone
See who a note is shared with, add a collaborator by email, and remove one when they no longer need access.
05
Clearing out old notes
Archive what you are done with, trash what you no longer need, and restore a note you removed by mistake.
23 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
add_list_item
Add an item to a checklist note.
add_note_collaborator
Add a collaborator email to a note.
archive_note
Archive or unarchive a note.
create_label
Create a label.
create_list
Create a new checklist note.
items should be objects like: {"text": "task", "checked": false}
create_note
Create a new note with title and text.
delete_label
Delete a label by ID.
delete_list_item
Delete a checklist item.
delete_note
Delete a note (mark for deletion).
find
Find notes using text and optional filters.
query matches title and text, case-insensitively unless case_sensitive is true. labels should be label IDs. colors should be ColorValue strings (e.g. DEFAULT, RED, CERULEAN). The date bounds accept ISO 8601 dates or datetimes, interpreted as UTC when no timezone is given (e.g. 2026-07-29 or 2026-07-29T12:00:00Z); after-bounds are inclusive, before-bounds exclusive. limit caps the number of returned notes.
get_note
Get a note by ID.
list_labels
List all labels.
list_note_collaborators
List collaborator emails for a note.
list_note_media
List note media blobs and direct media links when available.
pin_note
Pin or unpin a note.
remove_label_from_note
Remove a label from a note.
remove_note_collaborator
Remove a collaborator email from a note.
restore_note
Restore a trashed/deleted note.
set_note_color
Set a note color. Valid values: DEFAULT (white), RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN (dark blue), PURPLE, PINK, BROWN, GRAY.
trash_note
Move a note to trash.
update_list_item
Update checklist item text and/or checked state.
update_note
Update a note's properties.
BEFORE YOU INSTALL
What to know first
Tools you get
23 tools when we connected.
Requires
- uvx on PATH
- GOOGLE_EMAIL in your environment
- GOOGLE_MASTER_TOKEN in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 23 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"keep-mcp": {
"command": "uvx",
"args": [
"keep-mcp"
],
"env": {
"GOOGLE_EMAIL": "<YOUR_GOOGLE_EMAIL>",
"GOOGLE_MASTER_TOKEN": "<YOUR_GOOGLE_MASTER_TOKEN>"
}
}
}
}The README gets the token through gpsoauth's browser-assisted exchange; the token has full access to your account, so treat it like a password.
uvx
TERMINAL
uvx keep-mcp
