Google Tasks Assistant

Documentation Index

Fetch the complete documentation index at: https://docs.openhome.com/llms.txt

Use this file to discover all available pages before exploring further.

​

What It Does

• Adds tasks from a quick spoken request
• Supports step-by-step task creation for title, details, due date, and repeat notes
• Lets the user choose a task list when multiple Google task lists exist
• Reads incomplete tasks across all task lists
• Gives details about a selected task, including list name, due date, and notes
• Marks one or multiple tasks as complete
• Deletes selected tasks
• Renames existing tasks
• Understands task references by name, number, or partial description
• Continues with follow-up actions through Anything else?

​

Supported Requests

​

Example Prompts

• “Add grocery shopping.”
• “Add call Ahmed tomorrow.”
• “I need to remember something.”
• “Show my tasks.”
• “What’s on my list?”
• “Details on the second one.”
• “Mark the first one done.”
• “Complete birthday and holiday.”
• “Delete grocery shopping.”
• “Rename grocery shopping to buy groceries.”

​

Example Conversation

User: Add call Ahmed tomorrow. AI: Added call Ahmed for tomorrow. User: What’s on my list? AI: You have three open tasks. Call Ahmed tomorrow, grocery shopping, and book flight. User: Mark the first one done. AI: Done. Call Ahmed is complete.

​

Trigger Phrases

• google tasks
• tasks
• todo
• to-do list
• add a task
• show my tasks

​

Account Linking Guide

self.capability_worker.get_token("google")

1. Open OpenHome.
2. Go to Settings -> Linked Accounts.
3. Choose Google.
4. Sign in to the Google account you want to use.
5. Approve the requested Google permissions.
6. Return to OpenHome and enable or install the Google Tasks ability.
7. Add trigger phrases such as tasks, todo, and add a task.
8. Start a conversation and say one of the trigger phrases.

​

Data Access

​

Voice Flow

1. User triggers the ability.
2. The ability waits for the complete trigger transcription.
3. It checks for a linked Google account.
4. It builds a Google Tasks API service from the OpenHome Google token.
5. It classifies the request as ADD, VIEW, COMPLETE, DELETE, UPDATE, EXIT, or UNKNOWN.
6. If the request is unclear, it asks what the user wants to do.
7. It fetches current incomplete tasks when needed for matching.
8. It performs the selected task action.
9. It asks Anything else? for follow-up task actions.
10. The ability calls resume_normal_flow() when the session ends.

​

Developer Credit