keep-mcp

keep-mcp

9
cloud_platforms

The project is an MCP server designed for Google Keep, providing functionalities such as finding, creating, updating, and deleting notes. It requires Google account credentials to operate and restricts modification to notes created by the server unless explicitly overridden.

keep-mcp

MCP server for Google Keep

keep-mcp

How to use

  1. Add the MCP server to your MCP servers:
  "mcpServers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }
  1. Add your credentials:
  • GOOGLE_EMAIL: Your Google account email address
  • GOOGLE_MASTER_TOKEN: Your Google account master token

Check https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token and https://github.com/simon-weber/gpsoauth?tab=readme-ov-file#alternative-flow for more information.

Features

  • find: Search for notes based on a query string
  • create_note: Create a new note with title and text (automatically adds keep-mcp label)
  • update_note: Update a note's title and text
  • delete_note: Mark a note for deletion

By default, all destructive and modification operations are restricted to notes that have were created by the MCP server (i.e. have the keep-mcp label). Set UNSAFE_MODE to true to bypass this restriction.

"env": {
  ...
  "UNSAFE_MODE": "true"
}

Publishing

To publish a new version to PyPI:

  1. Update the version in pyproject.toml
  2. Build the package: 
    pipx run build
  3. Upload to PyPI: 
    pipx run twine upload --repository pypi dist/*

Troubleshooting