https://github.com/black-roland/homeassistant-microsoft-todo
The integration allows you to create tasks in Microsoft To Do from Home Assistant.
https://github.com/black-roland/homeassistant-microsoft-todo
homeassistant homeassistant-integration microsoft-todo todo
Last synced: about 2 months ago
JSON representation
The integration allows you to create tasks in Microsoft To Do from Home Assistant.
- Host: GitHub
- URL: https://github.com/black-roland/homeassistant-microsoft-todo
- Owner: black-roland
- License: mit
- Created: 2019-10-28T22:43:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-10T15:13:46.000Z (over 1 year ago)
- Last Synced: 2023-11-10T16:30:16.273Z (over 1 year ago)
- Topics: homeassistant, homeassistant-integration, microsoft-todo, todo
- Language: Python
- Homepage:
- Size: 107 KB
- Stars: 105
- Watchers: 7
- Forks: 9
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# DEPRECATED
Please use [O365-HomeAssistant](https://github.com/RogerSelwyn/O365-HomeAssistant) instead. For the migration guide take a look at [#98](https://github.com/black-roland/homeassistant-microsoft-todo/issues/98#issuecomment-1805910455).
---
# Microsoft To Do integration for Home Assistant
The integration brings your Microsoft To Do tasks into Home Assistant and allows creating new tasks.
## Work in progress
Work is still in progress and there might be breaking changes. Tasks for the 1st release are tracked on [the MVP board](https://github.com/black-roland/homeassistant-microsoft-todo/projects/2).
## Installation
This component can be installed using [HACS](https://github.com/hacs/integration). Simply add a custom repository `black-roland/homeassistant-microsoft-todo` and install the integration.
Alternatively, that's possible to copy the content of the `custom_components` to [the config directory](https://developers.home-assistant.io/docs/creating_integration_file_structure#where-home-assistant-looks-for-integrations).
## Setup
To get access to Microsoft To Do API you need to register an application in Azure:
1. Open [Azure portal](https://portal.azure.com/#home);
1. Go to app registrations:
1. Register a new personal app and obtain client ID and secret:
1. Add a redirect URI: `https://[YOUR HOME ASSISTANT URL:PORT]/api/microsoft-todo`, replace `[YOUR HOME ASSISTANT URL:PORT]` with the domain name and port of our Home Assistant instance:
To be able to authenticate please make sure that [Home Assistant URL](https://www.home-assistant.io/docs/configuration/basic/#external_url) is configured properly and your browser can access the redirect URL (it doesn’t have to be accessible from the Internet, it can be even `localhost`).
## Configuration
Add the following section to your `configuration.yaml` file:
```yaml
calendar:
- platform: microsoft_todo
client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
```
Restart Home Assistant and finalize authorization through UI. There should be a new configuration request in notifications.
*NOTE*: After successful auth please restart your Home Assistant again (it's known issue #10).
## Services
To create a task in Microsoft To Do you can call `microsoft_todo.new_task` service.
Simple example:
```yaml
- service: microsoft_todo.new_task
data:
subject: "Test task"
list_name: "Home Assistant"
```
Automation example:
```yaml
automation:
- alias: "Remind to pay utility bill"
trigger:
platform: time
at: "00:00:00"
condition:
condition: template
value_template: "{{ now().day == 1 }}"
action:
- service: microsoft_todo.new_task
data_template:
subject: "Pay utility bill for {{ now().replace(month=now().month - 1).strftime('%B') }}" # previous month name
list_name: "Home Assistant"
note: "Pay online: http://example.com/pay/"
due_date: "{{ now().strftime('%Y-%m-09') }}" # due 9th
reminder_date_time: "{{ now().strftime('%Y-%m-%dT17:00:00') }}" # at 17:00 today
```
## Calendar sensors
The integration creates sensors for each to-do list with tasks exposed as `all_tasks` attribute. You can find sensors on the Developer Tools page prefixed with `calendar.`.
Sensors can be used in automations:
```yaml
automation:
- alias: "Remind to buy groceries after work"
trigger:
platform: state
entity_id: person.bob
from: "office"
to: "away"
condition:
condition: template
value_template: "{{ state_attr('calendar.shopping_list', 'all_tasks') | length > 0 }}"
action:
- service: notify.email_bob
data:
title: "Shopping list"
message: "Don't forget to check your shopping list before going home"
```
Or sensors can be used in Lovelace. There are multiple ways to show your tasks: by simply using [ssmorris/lovelace-attribute-list-view](https://github.com/ssmorris/lovelace-attribute-list-view) card or by adding a custom markdown card with Jinja template:
```yaml
type: markdown
content: |-
{% for task in state_attr('calendar.PUT_YOUR_LIST_NAME_HERE', 'all_tasks') -%}
- {{ task }}
{% endfor %}
title: To Do
```
