{"id":19024791,"url":"https://github.com/piotrmachowski/home-assistant-custom-components-google-keep","last_synced_at":"2026-02-18T16:31:09.916Z","repository":{"id":37725651,"uuid":"199549304","full_name":"PiotrMachowski/Home-Assistant-custom-components-Google-Keep","owner":"PiotrMachowski","description":"This sensor uses gkeepapi library to download a list of notes from https://keep.google.com/.","archived":false,"fork":false,"pushed_at":"2025-04-05T00:26:23.000Z","size":27,"stargazers_count":69,"open_issues_count":7,"forks_count":8,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-23T11:57:54.346Z","etag":null,"topics":["custom-component","home-assistant","integration","notes"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PiotrMachowski.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"ko_fi":"piotrmachowski","custom":["buycoffee.to/piotrmachowski","paypal.me/PiMachowski","revolut.me/314ma"]}},"created_at":"2019-07-30T01:10:02.000Z","updated_at":"2025-04-05T00:26:26.000Z","dependencies_parsed_at":"2024-11-08T20:42:49.948Z","dependency_job_id":"21612b42-053d-441d-b53c-aa7ca61110a1","html_url":"https://github.com/PiotrMachowski/Home-Assistant-custom-components-Google-Keep","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrMachowski%2FHome-Assistant-custom-components-Google-Keep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrMachowski%2FHome-Assistant-custom-components-Google-Keep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrMachowski%2FHome-Assistant-custom-components-Google-Keep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiotrMachowski%2FHome-Assistant-custom-components-Google-Keep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PiotrMachowski","download_url":"https://codeload.github.com/PiotrMachowski/Home-Assistant-custom-components-Google-Keep/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250430589,"owners_count":21429323,"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","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":["custom-component","home-assistant","integration","notes"],"created_at":"2024-11-08T20:38:37.355Z","updated_at":"2026-02-18T16:31:09.903Z","avatar_url":"https://github.com/PiotrMachowski.png","language":"Python","funding_links":["https://ko-fi.com/piotrmachowski","buycoffee.to/piotrmachowski","paypal.me/PiMachowski","revolut.me/314ma","https://ko-fi.com/piotrmachowski'","https://paypal.me/PiMachowski","https://www.buymeacoffee.com/PiotrMachowski"],"categories":[],"sub_categories":[],"readme":"[![HACS Default][hacs_shield]][hacs]\n[![GitHub Latest Release][releases_shield]][latest_release]\n[![GitHub All Releases][downloads_total_shield]][releases]\n[![Community Forum][community_forum_shield]][community_forum]\u003c!-- piotrmachowski_support_badges_start --\u003e\n[![Ko-Fi][ko_fi_shield]][ko_fi]\n[![buycoffee.to][buycoffee_to_shield]][buycoffee_to]\n[![PayPal.Me][paypal_me_shield]][paypal_me]\n[![Revolut.Me][revolut_me_shield]][revolut_me]\n\u003c!-- piotrmachowski_support_badges_end --\u003e\n\n\n[hacs_shield]: https://img.shields.io/static/v1.svg?label=HACS\u0026message=Default\u0026style=popout\u0026color=green\u0026labelColor=41bdf5\u0026logo=HomeAssistantCommunityStore\u0026logoColor=white\n[hacs]: https://hacs.xyz/docs/default_repositories\n\n[latest_release]: https://github.com/PiotrMachowski/Home-Assistant-custom-components-Google-Keep/releases/latest\n[releases_shield]: https://img.shields.io/github/release/PiotrMachowski/Home-Assistant-custom-components-Google-Keep.svg?style=popout\n\n[releases]: https://github.com/PiotrMachowski/Home-Assistant-custom-components-Google-Keep/releases\n[downloads_total_shield]: https://img.shields.io/github/downloads/PiotrMachowski/Home-Assistant-custom-components-Google-Keep/total\n\n[community_forum_shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=Forum\u0026style=popout\u0026color=41bdf5\u0026logo=HomeAssistant\u0026logoColor=white\n[community_forum]: https://community.home-assistant.io/t/google-keep-custom-component-and-lovelace-card/131752\n\n# Google Keep sensor\n\nThis sensor downloads a list of notes from [*Google Keep*](https://keep.google.com/).\n \n## Configuration options\n\n| Key | Type | Required | Default | Description |\n| --- | --- | --- | --- | --- |\n| `name` | `string` | `False` | `Google Keep` | Name of sensor |\n| `username` | `string` | `True` | - | Username for Google Keep account |\n| `password` | `string` | `True` | - | Password (or App Password) for Google Keep account |\n| `titles` | `list` | `False` | `[]` | List of titles of notes to be imported |\n| `labels` | `list` | `False` | `[]` | List of labels of notes to be imported |\n| `pinned` | `boolean` | `False` | `False` | Activates downloaded limiting notes to pinned ones |\n\n## Example usage\n\n```\nsensor:\n  - platform: google_keep\n    username: !secret google_keep.username\n    password: !secret google_keep.password\n    labels:\n      - 'Home Assistant'\n    pinned: true\n```\n\n## Installation\n\n### Using [HACS](https://hacs.xyz/) (recommended)\n\nThis integration can be installed using HACS.\nTo do it search for `Google Keep` in *Integrations* section.\n\n### Manual\n\nTo install this integration manually you have to download [*google_keep.zip*](https://github.com/PiotrMachowski/Home-Assistant-custom-components-Google-Keep/releases/latest/download/google_keep.zip) and extract its contents to `config/custom_components/google_keep` directory:\n```bash\nmkdir -p custom_components/google_keep\ncd custom_components/google_keep\nwget https://github.com/PiotrMachowski/Home-Assistant-custom-components-Google-Keep/releases/latest/download/google_keep.zip\nunzip google_keep.zip\nrm google_keep.zip\n```\n\n## Hints\n\n* To present data downloaded by this sensor use companion card: [*Lovelace Google Keep card*](https://github.com/PiotrMachowski/Lovelace-Google-Keep-card)\n\n* If you define more than one constraint (`titles`, `labels`, `pinned`) all of them will be applied and intersection of results will be returned.\n\n* **Do I have to use my Google Account password?**\n\n  You can set up an App Password to use this component.\n  * Go to [https://myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords)\n  * In `Select app` menu choose `other` and provide your own identifier (e.g. `Home Assistant`)\n  * Use generated password in sensor configuration (**Warning:** password will not be shown again!)\n  \n\n* **What to do if Home Assistant does not find this component?**\n\n  Most likely you have to install additional dependency required for it to run. Activate Python environment Home Assistant is running in and use following command:\n  ```bash\n  pip install gkeepapi\n  ```\n\n\n\u003c!-- piotrmachowski_support_links_start --\u003e\n\n## Support\n\nIf you want to support my work with a donation you can use one of the following platforms:\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003ePlatform\u003c/th\u003e\n    \u003cth\u003ePayment methods\u003c/th\u003e\n    \u003cth\u003eLink\u003c/th\u003e\n    \u003cth\u003eComment\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eKo-fi\u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003ePayPal\u003c/li\u003e\n      \u003cli\u003eCredit card\u003c/li\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href='https://ko-fi.com/piotrmachowski' target='_blank'\u003e\u003cimg height='35px' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003eNo fees\u003c/li\u003e\n      \u003cli\u003eSingle or monthly payment\u003c/li\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003ebuycoffee.to\u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003eBLIK\u003c/li\u003e\n      \u003cli\u003eBank transfer\u003c/li\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://buycoffee.to/piotrmachowski\" target=\"_blank\"\u003e\u003cimg src=\"https://buycoffee.to/btn/buycoffeeto-btn-primary.svg\" height=\"35px\" alt=\"Postaw mi kawę na buycoffee.to\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003ePayPal\u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003ePayPal\u003c/li\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://paypal.me/PiMachowski\" target=\"_blank\"\u003e\u003cimg src=\"https://www.paypalobjects.com/webstatic/mktg/logo/pp_cc_mark_37x23.jpg\" border=\"0\" alt=\"PayPal Logo\" height=\"35px\" style=\"height: auto !important;width: auto !important;\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003eNo fees\u003c/li\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003eRevolut\u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003eRevolut\u003c/li\u003e\n      \u003cli\u003eCredit Card\u003c/li\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003ca href=\"https://revolut.me/314ma\" target=\"_blank\"\u003e\u003cimg src=\"https://assets.revolut.com/assets/favicons/favicon-32x32.png\" height=\"32px\" alt=\"Revolut\"\u003e\u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n      \u003cli\u003eNo fees\u003c/li\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n### Powered by\n[![PyCharm logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSourceSupport)\n\n\n[ko_fi_shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=Ko-Fi\u0026color=F16061\u0026logo=ko-fi\u0026logoColor=white\n\n[ko_fi]: https://ko-fi.com/piotrmachowski\n\n[buycoffee_to_shield]: https://shields.io/badge/buycoffee.to-white?style=flat\u0026labelColor=white\u0026logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABhmlDQ1BJQ0MgcHJvZmlsZQAAKJF9kT1Iw1AUhU9TpaIVh1YQcchQnayIijhKFYtgobQVWnUweemP0KQhSXFxFFwLDv4sVh1cnHV1cBUEwR8QVxcnRRcp8b6k0CLGC4/3cd49h/fuA4R6malmxzigapaRisfEbG5FDLzChxB6MIZ+iZl6Ir2QgWd93VM31V2UZ3n3/Vm9St5kgE8knmW6YRGvE09vWjrnfeIwK0kK8TnxqEEXJH7kuuzyG+eiwwLPDBuZ1BxxmFgstrHcxqxkqMRTxBFF1ShfyLqscN7irJarrHlP/sJgXltOc53WEOJYRAJJiJBRxQbKsBClXSPFRIrOYx7+QcefJJdMrg0wcsyjAhWS4wf/g9+zNQuTE25SMAZ0vtj2xzAQ2AUaNdv+PrbtxgngfwautJa/UgdmPkmvtbTIEdC3DVxctzR5D7jcAQaedMmQHMlPSygUgPcz+qYcELoFulfduTXPcfoAZGhWSzfAwSEwUqTsNY93d7XP7d+e5vx+AIahcq//o+yoAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH5wETCy4vFNqLzwAAAVpJREFUOMvd0rFLVXEYxvHPOedKJnKJhrDLuUFREULE7YDCMYj+AydpsCWiaKu29hZxiP4Al4aWwC1EdFI4Q3hqEmkIBI8ZChWXKNLLvS0/Qcza84V3enm/7/s878t/HxGkeTaIGziP+EB918nawu7Dq1d0e1+2J2bepnk2jFEUVVF+qKV51o9neBCaugfge70keoxxUbSWjrQ+4SUyzKZ5NlnDZdzGG7w4DIh+dtZEFntDA98l8S0MYwctNGrYz9WqKJePFLq80g5Sr+EHlnATp+NA+4qLaZ7FfzMrzbMBjGEdq8GrJMZnvAvFC/8wfAwjWMQ8XmMzaW9sdevNRgd3MFhvNpbaG1u/Dk2/hOc4gadVUa7Um425qii/7Z+xH9O4jwW8Cqv24Tru4hyeVEU588cfBMgpPMI9nMFe0BkFzVOYrYqycyQgQJLwTC2cDZCPeF8V5Y7jGb8BUpRicy7OU5MAAAAASUVORK5CYII=\n\n[buycoffee_to]: https://buycoffee.to/piotrmachowski\n\n[buy_me_a_coffee_shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=Buy%20me%20a%20coffee\u0026color=6f4e37\u0026logo=buy%20me%20a%20coffee\u0026logoColor=white\n\n[buy_me_a_coffee]: https://www.buymeacoffee.com/PiotrMachowski\n\n[paypal_me_shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=PayPal.Me\u0026logo=paypal\n\n[paypal_me]: https://paypal.me/PiMachowski\n\n[revolut_me_shield]: https://img.shields.io/static/v1.svg?label=%20\u0026message=Revolut\u0026logo=revolut\n\n[revolut_me]: https://revolut.me/314ma\n\u003c!-- piotrmachowski_support_links_end --\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrmachowski%2Fhome-assistant-custom-components-google-keep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiotrmachowski%2Fhome-assistant-custom-components-google-keep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiotrmachowski%2Fhome-assistant-custom-components-google-keep/lists"}