# Google Keep — how to use (mcp.ai)

MCP do Google Keep, leia e edite suas notas, listas, labels e colaboradores. Conecta com email + master token do Google (não há API oficial; usamos a API privada do app Android via master token, como o gkeepapi). Suporta múltiplas contas Google. Servidor stateless rodando em Cloudflare Workers; credenciais ficam só na WCA da plataforma. Por padrão só gere notas marcadas com a label 'keep-mcp' (passe unsafe=true pra agir sobre qualquer nota).

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_keep?ms=1781044140000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `keep_add_label_to_note`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/keep`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/keep/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/keep/add/label/to/note` — Anexa uma label (por nome, criada se não existir) a uma nota.
  - body: { note_id: string, label: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/add/list/item` — Adiciona um item a uma checklist.
  - body: { note_id: string, text: string, checked?: boolean, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/add/note/collaborator` — Compartilha uma nota com um colaborador (por email).
  - body: { note_id: string, email: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/archive/note` — Arquiva ou desarquiva uma nota (`archived`, default true).
  - body: { note_id: string, archived?: boolean, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/create/label` — Cria uma nova label.
  - body: { name: string, account?: string }
- `POST https://api.mcp.ai/api/keep/create/list` — Cria uma checklist no Google Keep. `items` = array de { text, checked }. Recebe a label 'keep-mcp' automaticamente.
  - body: { title?: string, items?: object[], account?: string }
- `POST https://api.mcp.ai/api/keep/create/note` — Cria uma nota de texto no Google Keep. Recebe a label 'keep-mcp' automaticamente pra poder ser gerida depois.
  - body: { title?: string, text?: string, account?: string }
- `POST https://api.mcp.ai/api/keep/delete/label` — Apaga uma label pelo nome.
  - body: { name: string, account?: string }
- `POST https://api.mcp.ai/api/keep/delete/list/item` — Remove um item de checklist por item_id.
  - body: { item_id: string, unsafe?: boolean, account?: string, item_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/delete/note` — Apaga uma nota permanentemente (não dá pra desfazer).
  - body: { note_id: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/find` — Busca notas no Google Keep. Filtros opcionais: query (título/texto), labels, colors, pinned, archived, trashed (default false).
  - body: { query?: string, labels?: string[], colors?: string[], pinned?: boolean, archived?: boolean, trashed?: boolean, limit?: integer, account?: string }
- `POST https://api.mcp.ai/api/keep/get/note` — Retorna uma nota (ou lista) do Google Keep pelo id.
  - body: { note_id: string, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/list/accounts` — Lista as contas Google Keep vinculadas a este install (id/email, label). Use pra descobrir o `account` quando há várias.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/keep/list/labels` — Lista todas as labels da conta.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/keep/list/note/collaborators` — Lista os colaboradores (emails) com quem a nota é compartilhada.
  - body: { note_id: string, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/list/note/media` — Lista os blobs de mídia (imagens/áudio/desenhos) de uma nota, com links.
  - body: { note_id: string, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/pin/note` — Fixa ou desafixa uma nota (`pinned`, default true).
  - body: { note_id: string, pinned?: boolean, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/remove/label/from/note` — Remove uma label (por nome) de uma nota.
  - body: { note_id: string, label: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/remove/note/collaborator` — Remove um colaborador (por email) de uma nota.
  - body: { note_id: string, email: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/restore/note` — Restaura uma nota da lixeira.
  - body: { note_id: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/set/note/color` — Define a cor de uma nota. Uma de: DEFAULT, RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN, PURPLE, PINK, BROWN, GRAY.
  - body: { note_id: string, color: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/trash/note` — Move uma nota pra lixeira.
  - body: { note_id: string, unsafe?: boolean, account?: string, note_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/update/list/item` — Atualiza texto e/ou estado (checked) de um item de checklist (por item_id).
  - body: { item_id: string, text?: string, checked?: boolean, unsafe?: boolean, account?: string, item_ids?: string[] }
- `POST https://api.mcp.ai/api/keep/update/note` — Atualiza título e/ou texto de uma nota. Pra listas, edite os itens com os tools de list item.
  - body: { note_id: string, title?: string, text?: string, unsafe?: boolean, account?: string, note_ids?: string[] }

## Example prompts
- "Liste minhas notas do Google Keep"
- "Crie uma nota no Keep: 'Comprar pão e leite'"
- "Crie uma checklist de compras com ovos, café e arroz"

## More
- Page: https://mcp.ai/keep
- Agent spec (llms.txt): https://mcp.ai/keep/llms.txt
- Postman collection: https://mcp.ai/keep/postman.json