https://github.com/davenicoll/google-keep-mcp
An MCP server for Google Keep notes
https://github.com/davenicoll/google-keep-mcp
googlekeep keep mcp mcpserver notes
Last synced: about 2 months ago
JSON representation
An MCP server for Google Keep notes
- Host: GitHub
- URL: https://github.com/davenicoll/google-keep-mcp
- Owner: davenicoll
- License: other
- Created: 2025-08-12T22:49:06.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-08-12T23:59:35.000Z (10 months ago)
- Last Synced: 2025-08-13T01:26:08.718Z (10 months ago)
- Topics: googlekeep, keep, mcp, mcpserver, notes
- Language: Python
- Homepage: https://pypi.org/project/google-keep-mcp/
- Size: 10.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# google-keep-mcp
An MCP server for Google Keep. Apply the power of AI to organize, update, or just export your Keep notes.
## Features
### Search/List Operations
- `search_by_keyword` - Search notes by keyword against title and text content
- `search_by_label` - Search notes by label name
- `find` - Alias for `search_by_keyword` (backwards compatible)
- `get_pinned_notes` - Get pinned notes (with optional search)
- `get_archived_notes` - Get archived notes (with optional search)
- `get_trashed_notes` - Get trashed notes (with optional search)
All search/list operations return notes with `created`, `updated`, and `edited` ISO 8601 timestamps.
### Add Operations
- `create_note` - Create a new note with title and text
### Update Operations
- `update_note` - Update a note's title and text
- `set_note_color` - Set the color of a note (12 colors available)
- `archive_note` - Archive a note
- `unarchive_note` - Unarchive a note
- `restore_note` - Restore a trashed note back to an active note
### Delete Operations
- `delete_note` - Mark a note for deletion
- `delete_archived_note` - Permanently delete an archived note
### Utility Operations
- `get_labels` - Get all labels (with their usage count) for notes
- `get_note_colors` - Get available note colors and usage statistics
## How to use
1. Add the MCP server to your MCP servers:
```json
"mcpServers": {
"google-keep-mcp": {
"command": "pipx",
"args": [
"run",
"google-keep-mcp"
],
"env": {
"GOOGLE_EMAIL": "Your Google Email",
"GOOGLE_MASTER_TOKEN": "Your Google Master Token"
}
}
}
```
2. Add your credentials:
- `GOOGLE_EMAIL`: Your Google account email address
- `GOOGLE_MASTER_TOKEN`: Your Google account master token
Will you will need to create a master token (unless you have a Google Enterprise account, and can access the Google Keep API directly). Follow these steps:
- Goto https://myaccount.google.com/apppasswords and create an app password
- Run this docker command `docker run --rm -it breph/ha-google-home_get-token` and enter your gmail address and app password (make sure it doesn't have a space at the end)
- Obtain your master token. **Be careful with this token, it has access to everything in your Google account.**
> [!TIP]
> Stuck? Check https://github.com/leikoilja/ha-google-home/issues/890#issuecomment-2515002294, 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.
## 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/*
```