# Google Tasks — how to use (mcp.ai)

Google Tasks via linguagem natural: crie, liste, edite e conclua tarefas e listas de tarefas. Plataforma fornece a aplicação OAuth, você só clica em Conectar e escolhe sua conta Google. Várias contas Google podem ser conectadas no mesmo MCP.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_googletasks?ms=1781045280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `googletasks_clear_tasks`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/googletasks`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/googletasks/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/googletasks/clear/tasks` — Permanently clears all completed tasks from a specified google tasks list; this action is destructive and idempotent.
  - body: { tasklist: string }
- `POST https://api.mcp.ai/api/googletasks/create/task/list` — Creates a new task list with the specified title.
  - body: { tasklist_title: string }
- `POST https://api.mcp.ai/api/googletasks/delete/task` — Deletes a specified task from a given task list in google tasks.
  - body: { task_id: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googletasks/delete/task/list` — Permanently deletes an existing google task list, identified by `tasklist id`, along with all its tasks; this operation is irreversible.
  - body: { tasklist_id?: string }
- `POST https://api.mcp.ai/api/googletasks/get/task` — Use to retrieve a specific google task if its `task id` and parent `tasklist id` are known.
  - body: { task_id: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googletasks/get/task/list` — Retrieves a specific task list from the user's google tasks if the `tasklist id` exists for the authenticated user.
  - body: { tasklist_id: string }
- `POST https://api.mcp.ai/api/googletasks/insert/task` — Creates a new task in a given `tasklist id`, optionally as a subtask of an existing `task parent` or positioned after an existing `task previous` sibling, where both `task parent` and `task previous` 
  - body: { id?: string, due?: string, etag?: string, notes?: string, title: string, hidden?: boolean, status: string, deleted?: boolean, completed?: string, task_parent?: string, tasklist_id: string, task_previous?: string }
- `POST https://api.mcp.ai/api/googletasks/list/task/lists` — Fetches the authenticated user's task lists from google tasks; results may be paginated.
  - body: { pageToken?: string, maxResults?: integer }
- `POST https://api.mcp.ai/api/googletasks/list/tasks` — Retrieves tasks from a google tasks list; all date/time strings must be rfc3339 utc, and `showcompleted` must be true if `completedmin` or `completedmax` are specified.
  - body: { dueMax?: string, dueMin?: string, pageToken?: string, maxResults?: integer, showHidden?: boolean, updatedMin?: string, showDeleted?: boolean, tasklist_id: string, completedMax?: string, completedMin?: string, showCompleted?: boolean }
- `POST https://api.mcp.ai/api/googletasks/move/task` — Moves the specified task to another position in the destination task list.
  - body: { task: string, parent?: string, previous?: string, tasklist: string, destinationTasklist?: string }
- `POST https://api.mcp.ai/api/googletasks/patch/task` — Partially updates an existing task (identified by `task id`) within a specific google task list (identified by `tasklist id`), modifying only the provided attributes from `taskinput` (e.g., `title`, `
  - body: { id?: string, due?: string, etag?: string, notes?: string, title: string, hidden?: boolean, status: string, deleted?: boolean, task_id: string, completed?: string, tasklist_id: string }
- `POST https://api.mcp.ai/api/googletasks/patch/task/list` — Updates the title of an existing google tasks task list.
  - body: { tasklist_id: string, updated_title: string }
- `POST https://api.mcp.ai/api/googletasks/update/task` — Updates the specified task.
  - body: { due?: string, task: string, notes?: string, title?: string, status?: string, tasklist: string }
- `POST https://api.mcp.ai/api/googletasks/update/task/list` — Updates the authenticated user's specified task list.
  - body: { title: string, tasklist_id: string }

## Example prompts
- "Liste minhas tarefas pendentes de hoje"
- "Crie uma tarefa 'Pagar fornecedor' com prazo para sexta"
- "Marque a tarefa 'Enviar relatório' como concluída"

## More
- Page: https://mcp.ai/googletasks
- Agent spec (llms.txt): https://mcp.ai/googletasks/llms.txt
- Postman collection: https://mcp.ai/googletasks/postman.json