{"id":30221643,"url":"https://github.com/davenicoll/google-keep-mcp","last_synced_at":"2026-04-11T20:46:25.746Z","repository":{"id":309633038,"uuid":"1036995132","full_name":"davenicoll/google-keep-mcp","owner":"davenicoll","description":"An MCP server for Google Keep notes","archived":false,"fork":false,"pushed_at":"2025-08-12T23:59:35.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-13T01:26:08.718Z","etag":null,"topics":["googlekeep","keep","mcp","mcpserver","notes"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/google-keep-mcp/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davenicoll.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-12T22:49:06.000Z","updated_at":"2025-08-12T23:59:39.000Z","dependencies_parsed_at":"2025-08-13T01:26:15.618Z","dependency_job_id":"aa6799eb-8ecb-4fc4-a274-be921d59b9a0","html_url":"https://github.com/davenicoll/google-keep-mcp","commit_stats":null,"previous_names":["davenicoll/google-keep-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/davenicoll/google-keep-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davenicoll%2Fgoogle-keep-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davenicoll%2Fgoogle-keep-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davenicoll%2Fgoogle-keep-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davenicoll%2Fgoogle-keep-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davenicoll","download_url":"https://codeload.github.com/davenicoll/google-keep-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davenicoll%2Fgoogle-keep-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270198267,"owners_count":24543470,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-13T02:00:09.904Z","response_time":66,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["googlekeep","keep","mcp","mcpserver","notes"],"created_at":"2025-08-14T10:12:45.192Z","updated_at":"2026-04-11T20:46:25.738Z","avatar_url":"https://github.com/davenicoll.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# google-keep-mcp\n\nAn MCP server for Google Keep. Apply the power of AI to organize, update, or just export your Keep notes.\n\n## Features\n\n### Search/List Operations\n\n- `search_by_keyword` - Search notes by keyword against title and text content\n- `search_by_label` - Search notes by label name\n- `find` - Alias for `search_by_keyword` (backwards compatible)\n- `get_pinned_notes` - Get pinned notes (with optional search)\n- `get_archived_notes` - Get archived notes (with optional search)\n- `get_trashed_notes` - Get trashed notes (with optional search)\n\nAll search/list operations return notes with `created`, `updated`, and `edited` ISO 8601 timestamps.\n\n### Add Operations\n\n- `create_note` - Create a new note with title and text\n\n### Update Operations\n\n- `update_note` - Update a note's title and text\n- `set_note_color` - Set the color of a note (12 colors available)\n- `archive_note` - Archive a note\n- `unarchive_note` - Unarchive a note\n- `restore_note` - Restore a trashed note back to an active note\n\n### Delete Operations\n\n- `delete_note` - Mark a note for deletion\n- `delete_archived_note` - Permanently delete an archived note\n\n### Utility Operations\n\n- `get_labels` - Get all labels (with their usage count) for notes\n- `get_note_colors` - Get available note colors and usage statistics\n\n## How to use\n\n1. Add the MCP server to your MCP servers:\n\n```json\n  \"mcpServers\": {\n    \"google-keep-mcp\": {\n      \"command\": \"pipx\",\n      \"args\": [\n        \"run\",\n        \"google-keep-mcp\"\n      ],\n      \"env\": {\n        \"GOOGLE_EMAIL\": \"Your Google Email\",\n        \"GOOGLE_MASTER_TOKEN\": \"Your Google Master Token\"\n      }\n    }\n  }\n```\n\n2. Add your credentials:\n\n- `GOOGLE_EMAIL`: Your Google account email address\n- `GOOGLE_MASTER_TOKEN`: Your Google account master token\n\nWill 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:\n\n- Goto https://myaccount.google.com/apppasswords and create an app password\n- 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)\n- Obtain your master token. **Be careful with this token, it has access to everything in your Google account.**\n\n\u003e [!TIP]\n\u003e 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.\n\n## Publishing\n\nTo publish a new version to PyPI:\n\n1. Update the version in `pyproject.toml`\n2. Build the package:\n   ```bash\n   pipx run build\n   ```\n3. Upload to PyPI:\n   ```bash\n   pipx run twine upload --repository pypi dist/*\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavenicoll%2Fgoogle-keep-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavenicoll%2Fgoogle-keep-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavenicoll%2Fgoogle-keep-mcp/lists"}