Alfred Google Tasks Workflow

A reliable, fast way to manage your Google Tasks directly from Alfred 5.

🚀 Key Features

• task <text>: Create a new task in your default list.
• 📅 Date Support: Automatically parse due dates using:
  • @today
  • @tomorrow
  • @2026-12-25 (YYYY-MM-DD)
• tasklist: View your task lists and add items to specific ones.
• tasksetup: Guided interactive OAuth 2.0 setup.

💼 Workspace Account Support

This workflow is explicitly designed to work with Google Workspace accounts (as well as personal @gmail.com accounts).

Unlike unofficial "scraping" or password-based methods, this uses the official Google Tasks API and standard OAuth 2.0, which is the only reliable way to authenticate with Workspace security policies.

🛠 Setup

Because this uses the official API, you must provide your own client credentials to Google:

1. Get Credentials:

   • Go to the Google Cloud Console.
   • Create a new Project.
   • Enable the Google Tasks API.
   • Configure the OAuth Consent Screen (Choose "Internal" if you are a Workspace user).
   • Go to Credentials, click Create Credentials > OAuth client ID.
   • Select Desktop app.
   • Download the JSON, rename it to credentials.json.

2. Add to Workflow:

   • Install the workflow: dist/Google_Tasks-1.0.0.alfredworkflow.
   • Right-click the workflow in Alfred > Open in Finder.
   • Paste your credentials.json into the folder.

3. Authorize:

   • Run tasksetup in Alfred and follow the browser prompts.

📄 License

MIT