> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Google Tasks

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List every task on my `Work` list due this week, sorted by due date.
* Add a follow-up task to my `Personal` list for each unread email starred this morning.
* Move every completed task older than 30 days into the `Archive` list.

## Available Tools

#### list\_tasks

List tasks in a Google task list. Supports pagination and filters by completion, due date, or last update. Use...

#### get\_task

Get a task from a Google task list. Use list\_tasks to find valid IDs.

#### create\_task

Create a new task on a Google task list. Use parent to create a subtask, and previous to position it after a sibling...

#### update\_task

Update fields on a Google task. Set status to 'completed' to mark it done. Use list\_tasks to find valid IDs.

#### delete\_task

Delete a task from a Google task list permanently. This cannot be undone. Use list\_tasks to find valid IDs.

#### move\_task

Move a task to a new position, parent, or task list. Omit parent and previous to move to the top-level first position...

#### clear\_completed\_tasks

Hide all completed tasks from the specified task list. Hidden tasks can still be retrieved by passing show\_hidden=true...

#### list\_tasklists

List the authenticated user's Google task lists. Supports pagination via page\_token. A user can have up to 2000 lists.

#### get\_tasklist

Get a Google task list by ID. Use list\_tasklists to find valid IDs.

#### create\_tasklist

Create a new Google task list with the given title.

#### update\_tasklist

Update a Google task list's title. Use list\_tasklists to find valid IDs.

#### delete\_tasklist

Delete a Google task list permanently. All tasks inside are also deleted. This cannot be undone. Use list\_tasklists to...