GOOGLESUPER_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 must belong to the same tasklist_id if specified. IMPORTANT: Date fields (due, completed) accept various fo...
This record as markdown: /tools/googlesuper/googlesuper-insert-task.md
What GOOGLESUPER_INSERT_TASK does on Google Super
AI agents use GOOGLESUPER_INSERT_TASK to create or update resources in Google Super, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Google Super environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | — | Unique identifier for the task. Generated by Google Tasks API when creating a task. Used for updating or deleting existing tasks. |
due | string | — | Due date for the task (optional). NOTE: Google Tasks only stores the date portion - any time provided will be normalized to midnight UTC by the API. Google Tas |
etag | string | — | ETag of the resource for concurrency control. Prevents accidental overwrites when multiple clients modify the same task. Auto-generated by the API. |
notes | string | — | Additional details or description for the task. Supports plain text only (no HTML/markdown). Maximum 8192 characters. Example: 'Include Q3 sales data and projec |
title | string | — | Title/name of the task (REQUIRED). This is the main text displayed for the task. Maximum 1024 characters. Example: 'Complete quarterly report' |
hidden | boolean | — | Whether the task is hidden from the default view. Hidden tasks can still be accessed via API but won't show in UI. Default: false |
status | string | — | Current status of the task (REQUIRED). Must be either 'needsAction' (task is pending) or 'completed' (task is done). Default: 'needsAction' |
deleted | boolean | — | Whether the task has been deleted. Deleted tasks are marked but not immediately removed, allowing for recovery. Default: false |
completed | string | — | Date/time when the task was marked as completed. Only applicable when status='completed'. Unlike 'due', this field preserves the time component. Google Tasks A |
task_parent | string | — | Identifier of an existing task to serve as parent; if provided, creates a subtask, otherwise a top-level task in the specified list. |
tasklist_id | string | — | Identifier for the Google Task list where the new task will be created. Use actual task list IDs, not '@default'. You can get list IDs using 'List Task Lists' a |
task_previous | string | — | Identifier of an existing task after which the new task will be placed, at the same hierarchical level (as a sibling). |
Parameters from the server's own tool schema.
Why GOOGLESUPER_INSERT_TASK is rated Medium
GOOGLESUPER_INSERT_TASK creates new tasks in Google Tasks, which is a reversible write operation. Tasks can be created, read, and deleted without permanent consequences or financial impact. The tool does not execute arbitrary code, delete data irreversibly, move money, or trigger destructive operations. A misdirected insertion of tasks has minimal blast radius—tasks can be manually or programmatically removed.
From the tool's definition 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.
Risk signalsHigh parameter count (12 properties)
Attacks that exploit this kind of access
The rule that runs GOOGLESUPER_INSERT_TASK safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Google Super, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For GOOGLESUPER_INSERT_TASK, this is the rule to start with:
GOOGLESUPER_INSERT_TASK stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Google Super, apply this rule, and every GOOGLESUPER_INSERT_TASK call is checked against it from then on.
Questions about GOOGLESUPER_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 must belong to the same tasklist_id if specified. IMPORTANT: Date fields (due, completed) accept various formats like '28 Sep 2025', '11:59 PM, 22 Sep 2025', or ISO format '2025-09-21T15:30:00Z' and will automatically convert them to RFC3339 format required by the API. It is categorised as a Write tool in the Google Super MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
GOOGLESUPER_INSERT_TASK accepts 12 parameters: id, due, etag, notes, title, hidden, status, deleted, completed, task_parent, tasklist_id, task_previous. The full parameter table on this page comes from the server's own tool schema.
Register the Google Super MCP server in PolicyLayer and add a rule for GOOGLESUPER_INSERT_TASK: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Google Super. Nothing to install.
GOOGLESUPER_INSERT_TASK is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the GOOGLESUPER_INSERT_TASK rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for GOOGLESUPER_INSERT_TASK. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
GOOGLESUPER_INSERT_TASK is provided by the Google Super MCP server (googlesuper). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Google Super, and thousands of servers like it.
This server
Across the catalogue