> This page is for Workforce.

> 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...