keep-mcp

feuerdev/keep-mcp

🔗 Latest commit:e75b41c

🕒 Updated:Sep 9, 2025, 01:06 PM

Python

Knowledge

MCP server for Google Keep

MCP Trust Score

Based on our comprehensive evaluation criteria

🤖 Evaluated by gemini-2.5-flashFix

Trust Score52/100

• Core MCP protocol features implemented (22/40)
• Room for improvement in GitHub community
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

GitHub Metrics

Repository statistics and activity

⭐ GitHub Stars:27

👥 Contributors:2

📋 Total Issues:2

📦 Has Releases:No

🔧 Has CI/CD Pipeline:No

Configuration

Configuration example extracted from README.md for Claude Desktop and other clients.

🤖 Evaluated by gemini-2.5-flashFix

{
  "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"
    }
  },
  "keep-mcp-pipx-unsafe": {
    "command": "pipx",
    "args": [
      "run",
      "keep-mcp"
    ],
    "env": {
      "GOOGLE_EMAIL": "Your Google Email",
      "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md",
      "UNSAFE_MODE": "true"
    }
  }
}

MCP Protocol Support

Implemented MCP protocol features

🤖 Evaluated by gemini-2.5-flashFix

Tools:✓

Prompts:✗

Resources:✓

Sampling:✗

Roots:✗

Logging:✗

STDIO Transport:✓

HTTP Transport:✗

OAuth2 Auth:✓

Dependencies

2 dependencies

Libraries and frameworks used by this MCP server

🤖 Evaluated by gemini-2.5-flashFix

Main

mcp

gkeepapi

README.md

keep-mcp

MCP server for Google Keep

keep-mcp

How to use

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"
      }
    }
  }

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:

Update the version in pyproject.toml
Build the package:
```
pipx run build
```

Upload to PyPI:

pipx run twine upload --repository pypi dist/*

Troubleshooting

If you get "DeviceManagementRequiredOrSyncDisabled" check https://admin.google.com/ac/devices/settings/general and turn "Turn off mobile management (Unmanaged)"

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/feuerdev/keep-mcp)](https://archestra.ai/mcp-catalog/feuerdev__keep-mcp)

Edit This Server Add New MCP Server Report an Issue

README.md

keep-mcp

MCP server for Google Keep

keep-mcp

How to use

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"
      }
    }
  }

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

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

Publishing

To publish a new version to PyPI:

Update the version in pyproject.toml
Build the package:
```
pipx run build
```

Upload to PyPI:

pipx run twine upload --repository pypi dist/*

Troubleshooting

If you get "DeviceManagementRequiredOrSyncDisabled" check https://admin.google.com/ac/devices/settings/general and turn "Turn off mobile management (Unmanaged)"