Google Keep

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

Google Keep MCP, read and edit your notes, lists, labels and collaborators. Connect with your Google

The publisher's own server: Keep

VerifiedStreamable HTTPWeb executableProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

Lets an assistant read and edit Google Keep notes, checklists, labels, and collaborators through a hosted remote MCP endpoint.

What you can do
A hosted Google Keep MCP server exposing 24 tools for reading and writing notes. It can list linked accounts, search notes by query, label, color, pinned, archived or trashed state, fetch a note by id, create text notes and checklists, update titles and text, pin, archive, recolor, trash, restore or permanently delete notes, add, update and remove checklist items, manage labels, share notes with collaborators by email, and list a note's media blobs. By default it only operates on notes carrying the 'keep-mcp' label unless unsafe mode is enabled.
When to use it
Useful when an assistant should capture, look up, or organize personal notes and shopping or task checklists in Google Keep, or manage labels and note sharing, without leaving the chat client. It fits users who already keep their notes in Google Keep and want an MCP client such as Claude, Cursor, VS Code, or another MCP-over-HTTP client to act on them.
Requirements
A remote MCP endpoint reached over MCP over HTTP; no local package or runtime is needed. It requires a Google account connected by email plus a Google master token, since it uses the private Android app API rather than an official API. Multiple Google accounts are supported, and login is done by magic link rather than a password.
Before you install
It asks for a Google master token, which grants broad access to the account's Keep data; treat it as a sensitive credential. Tools can write, share, trash, and permanently delete notes, and delete operations cannot be undone. By default only notes labeled 'keep-mcp' are touched, but unsafe mode extends actions to any note. Data returned by the tools is sent to whichever LLM host is used, a sub-processor outside the provider's control.

Installation

In SourceWeft

  1. Open Google Keep in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fkeep-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "google-keep": {
      "type": "http",
      "url": "https://api.mcp.ai/p_keep"
    }
  }
}

README

This repository has no README.

Tools

30

keep_list_accounts

List Linked Google Keep Accounts

Lista as contas Google Keep vinculadas a este install (id/email, label). Use pra descobrir o `account` quando há várias.

Parametersaccount

keep_find

Find Notes

Busca notas no Google Keep. Filtros opcionais: query (título/texto), labels, colors, pinned, archived, trashed (default false).

Parameterslimitquerycolorslabelspinnedaccounttrashedarchived

keep_get_note

Get Note

Retorna uma nota (ou lista) do Google Keep pelo id. Bulk support: accepts note_ids for batched execution.

Parametersaccountnote_idrequirednote_ids

keep_create_note

Create Note

Cria uma nota de texto no Google Keep. Recebe a label 'keep-mcp' automaticamente pra poder ser gerida depois.

Parameterstexttitleaccount

keep_create_list

Create Checklist

Cria uma checklist no Google Keep. `items` = array de { text, checked }. Recebe a label 'keep-mcp' automaticamente.

Parametersitemstitleaccount

keep_update_note

Update Note

Atualiza título e/ou texto de uma nota. Pra listas, edite os itens com os tools de list item. Bulk support: accepts note_ids for batched execution.

Parameterstexttitleunsafeaccountnote_idrequirednote_ids

keep_pin_note

Pin / Unpin Note

Fixa ou desafixa uma nota (`pinned`, default true). Bulk support: accepts note_ids for batched execution.

Parameterspinnedunsafeaccountnote_idrequirednote_ids

keep_archive_note

Archive / Unarchive Note

Arquiva ou desarquiva uma nota (`archived`, default true). Bulk support: accepts note_ids for batched execution.

Parametersunsafeaccountnote_idrequiredarchivednote_ids

keep_set_note_color

Set Note Color

Define a cor de uma nota. Uma de: DEFAULT, RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN, PURPLE, PINK, BROWN, GRAY. Bulk support: accepts note_ids for batched execution.

Parameterscolorrequiredunsafeaccountnote_idrequirednote_ids

keep_trash_note

Trash Note

Move uma nota pra lixeira. Bulk support: accepts note_ids for batched execution.

Parametersunsafeaccountnote_idrequirednote_ids

keep_restore_note

Restore Note

Restaura uma nota da lixeira. Bulk support: accepts note_ids for batched execution.

Parametersunsafeaccountnote_idrequirednote_ids

keep_delete_note

Delete Note

Apaga uma nota permanentemente (não dá pra desfazer). Bulk support: accepts note_ids for batched execution.

Parametersunsafeaccountnote_idrequirednote_ids

keep_add_list_item

Add List Item

Adiciona um item a uma checklist. Bulk support: accepts note_ids for batched execution.

Parameterstextrequiredunsafeaccountcheckednote_idrequirednote_ids

keep_update_list_item

Update List Item

Atualiza texto e/ou estado (checked) de um item de checklist (por item_id). Bulk support: accepts item_ids for batched execution.

Parameterstextunsafeaccountcheckeditem_idrequireditem_ids

keep_delete_list_item

Delete List Item

Remove um item de checklist por item_id. Bulk support: accepts item_ids for batched execution.

Parametersunsafeaccountitem_idrequireditem_ids

keep_list_labels

List Labels

Lista todas as labels da conta.

Parametersaccount

keep_create_label

Create Label

Cria uma nova label.

Parametersnamerequiredaccount

keep_delete_label

Delete Label

Apaga uma label pelo nome.

Parametersnamerequiredaccount

keep_add_label_to_note

Add Label to Note

Anexa uma label (por nome, criada se não existir) a uma nota. Bulk support: accepts note_ids for batched execution.

Parameterslabelrequiredunsafeaccountnote_idrequirednote_ids

keep_remove_label_from_note

Remove Label from Note

Remove uma label (por nome) de uma nota. Bulk support: accepts note_ids for batched execution.

Parameterslabelrequiredunsafeaccountnote_idrequirednote_ids

keep_list_note_collaborators

List Note Collaborators

Lista os colaboradores (emails) com quem a nota é compartilhada. Bulk support: accepts note_ids for batched execution.

Parametersaccountnote_idrequirednote_ids

keep_add_note_collaborator

Add Note Collaborator

Compartilha uma nota com um colaborador (por email). Bulk support: accepts note_ids for batched execution.

Parametersemailrequiredunsafeaccountnote_idrequirednote_ids

keep_remove_note_collaborator

Remove Note Collaborator

Remove um colaborador (por email) de uma nota. Bulk support: accepts note_ids for batched execution.

Parametersemailrequiredunsafeaccountnote_idrequirednote_ids

keep_list_note_media

List Note Media

Lista os blobs de mídia (imagens/áudio/desenhos) de uma nota, com links. Bulk support: accepts note_ids for batched execution.

Parametersaccountnote_idrequirednote_ids

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameterscontextmessagerequiredconversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Takes no parameters.

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Takes no parameters.

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.

Other Keep integrations