> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Track To-Dos in Google Tasks From AI Agents

> Let agents create, complete, and organize tasks and task lists in Google Tasks, with OAuth tokens injected by the gateway so agents never handle them.

> [!WARNING]
>
> **Per-app Google setup is deprecated.** All Google apps now share one Google OAuth client and one Redirect URI. To use your own client, follow the [Google setup guide](/docs/integrations/google.md). Credentials saved for one Google app apply to all of them.

## Overview

Buckle connects AI agents to Google Tasks through Google's OAuth flow. Agents can create tasks, mark them complete, and organize them into task lists. The gateway injects OAuth credentials into requests to the Google Tasks API automatically.

This is useful for agents that need to track follow-up items, create to-do lists, or manage tasks alongside Google Calendar.

## What you will set up

* A Google OAuth client shared by every Google app in Buckle
* A Google Tasks connection authorized with your account
* Per-agent, per-tool access to your task lists

## Connect Google Tasks

> [!NOTE]
>
> This applies on Buckle Cloud and self-hosted alike. One Google client serves every Google app in Buckle, so you set it up once. If you already did it for another Google app, skip to step 2.

> [accordion] 1. Set up your Google client
>
> Follow the [Google setup guide](/docs/integrations/google.md). It enables the Google APIs, sets up the consent screen, creates the OAuth client, and adds the Redirect URI.

> [accordion] 2. Connect Google Tasks
>
> Open **Settings** > **Apps** > **Google Tasks**, select **Connect Google Tasks**, pick your Google account, and click **Allow**.
>
> ![Buckle connect window for Google Tasks showing Configuration required, the setup guide link, and the Configure credentials button.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-tasks/buckle-connect-google-tasks.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=c2f3afd6dd1b599380bd8c7a9d2cb5cc)
>
> The Google Tasks connect window before a Google client is set up.

## What agents can do

* List all task lists on the account
* Create, rename, and delete task lists
* List tasks within a task list, optionally showing completed tasks
* Create new tasks with a title, notes, and due date
* Update task details (title, notes, due date, status)
* Mark tasks as completed
* Delete tasks
* Move tasks to change their order or parent (for sub-tasks)
* Clear all completed tasks from a list

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Google Tasks.

## FAQ

> [accordion] Do I need my own Google client for Tasks?
>
> Yes. Follow the [Google setup guide](/docs/integrations/google.md) once. One client serves every Google app in Buckle.

> [accordion] Does the agent see my Google token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] How do I reconnect Google Tasks?
>
> Open **Settings** > **Apps** > **Google Tasks** and connect again. Agents with [access](/docs/guides/agent-access.md) use the new connection automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.