MCP.so
Sign In

keep-mcp

@feuerdev

Repository

About keep-mcp

MCP server for Google Keep

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

feuerdev

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Servers

modelcontextprotocol

Model Context Protocol Servers

88.2K