https://github.com/feuerdev/keep-mcp
MCP server for Google Keep
https://github.com/feuerdev/keep-mcp
Last synced: 17 days ago
JSON representation
MCP server for Google Keep
- Host: GitHub
- URL: https://github.com/feuerdev/keep-mcp
- Owner: feuerdev
- License: mit
- Created: 2025-03-31T23:22:45.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-07T22:44:34.000Z (about 1 month ago)
- Last Synced: 2025-04-07T23:29:12.875Z (about 1 month ago)
- Language: Python
- Homepage:
- Size: 33.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Google Keep - Read, create, update and delete Google Keep notes. (Community Servers)
README
# keep-mcp
MCP server for Google Keep
## How to use
1. Add the MCP server to your MCP servers:
```json
"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"
}
}
}
```
2. 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:
```bash
pipx run build
```
3. Upload to PyPI:
```bash
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)"