keep-mcp

Name: keep-mcp
Author: feuerdev

@feuerdev

代码仓库

关于 keep-mcp

MCP server for Google Keep

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

feuerdev

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "keep-mcp": {
      "command": "uv",
      "args": [
        "venv",
        "--python",
        "3.11",
        ".venv"
      ],
      "env": {
        "UV_CACHE_DIR": "/tmp/uv-cache"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is keep-mcp?

keep-mcp is a Model Context Protocol (MCP) server that provides a structured interface to Google Keep. It enables AI assistants and MCP clients to search, create, update, and manage Google Keep notes, lists, labels, collaborators, and media attachments using the user’s Google credentials.

How to use keep-mcp?

Add keep‑mcp to your MCP client’s configuration with the command pipx run keep-mcp and environment variables GOOGLE_EMAIL and GOOGLE_MASTER_TOKEN. Optionally set UNSAFE_MODE to true to allow modification of notes not created by the server. You can also run a local checkout via make start or uv run -m server.

Key features of keep-mcp

Search notes with filters for labels, colors, pinned/archived/trashed state
Create and update notes, checklist notes, and list items
Pin, archive, trash, restore, or delete notes
Set note color from twelve predefined values
Add, remove, and list labels and collaborators
List media blobs attached to a note
Safety mode restricts destructive operations to server‑created notes

Use cases of keep-mcp

An AI assistant can search a user’s Google Keep notes and retrieve content by ID
Automate note creation, checklist management, and note state changes from a chatbot
Sync or back up Keep notes by querying and updating them programmatically
Manage labels and collaborators across multiple notes in a workspace

FAQ from keep-mcp

What is the keep‑mcp label?

It’s automatically added to every note created by the server. By default, operations that modify or delete notes are restricted to notes that have this label.

How do I bypass the keep‑mcp label restriction?

Set the environment variable UNSAFE_MODE to true. This allows destructive operations on any note in the account, not just those created by the server.

How do I obtain a Google Master Token?

Follow the instructions at the gkeepapi documentation: https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token or the gpsoauth alternative flow.

What does “DeviceManagementRequiredOrSyncDisabled” mean?

Your Google Workspace admin may have mobile management enabled. Check https://admin.google.com/ac/devices/settings/general and turn “Turn off mobile management (Unmanaged)” on.

What runtime dependencies does keep‑mcp require?

Python 3.11, pipx, uv, and make are used for installation and local development. The server communicates with Google Keep APIs using a master token.

其他分类下的更多 MCP 服务器

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K