Google Tasks API

Name: Google Tasks API API
Brand: Google Tasks API
Availability: InStock

✓ Official Vendor SpecProductivityTask Managementoauth214 EndpointsREST

For Agents

Read and write a Google user's task lists and tasks — create tasks, mark them complete, reorder, and clear lists across the user's account.

Quickstart

Get started with Google Tasks API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"add a task to google tasks"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Google Tasks API API.

Create, update, and complete individual tasks within a user's task list

List all task lists for the authenticated user

Reorder tasks within a list using the move action

Clear all completed tasks from a list in a single call

Insert subtasks under a parent task with hierarchical structure

GET STARTED

Start building with Google Tasks API API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Google Tasks API API for, with concrete tasks.

★ AI Assistant Task Capture

An AI assistant transcribing a meeting extracts action items and writes them straight into the user's Google Tasks list. The assistant calls insert under /tasks/v1/lists/{tasklist}/tasks for each action item with a title, due date, and notes field referencing the meeting. The user sees the captured tasks appear in Gmail, Calendar, and the Tasks mobile app within seconds.

POST /tasks/v1/lists/@default/tasks with title='Send proposal to Acme', due='2026-06-17T17:00:00Z', and notes containing the source meeting link.

Cross-Tool Task Sync

A productivity dashboard syncs tasks bidirectionally between Google Tasks and a project management tool. The integration polls /tasks/v1/lists/{tasklist}/tasks with the updatedMin parameter to retrieve recently changed tasks, then mirrors them to the other system. Completion-state changes flow through patch calls so users can mark tasks done in either tool.

GET /tasks/v1/lists/{tasklist}/tasks?updatedMin=2026-06-10T00:00:00Z and for each modified task issue a PATCH against the corresponding task in the other system.

Workspace Onboarding Task Templates

An HR onboarding workflow creates a personalised task list for each new hire on day one. The system creates a fresh task list under the new hire's account, inserts a sequence of onboarding tasks (read handbook, set up dev environment, schedule 1:1s) with due dates spread over the first two weeks, and shares progress visibility with the manager. Existing employees see their onboarding tasks in the Google Tasks side panel inside Gmail.

Create a new tasklist via POST /tasks/v1/users/@me/lists named 'Onboarding Week 1', then insert 8 child tasks under it with sequential due dates.

Agent-Maintained Daily Plan via Jentic

An AI agent acts as a personal daily planner. Each morning it lists yesterday's incomplete tasks, reschedules them with new due dates, clears completed items, and inserts new tasks based on calendar events scraped from Calendar API. Through Jentic the agent's OAuth token is held in the vault and refreshed automatically across runs.

Through Jentic, search 'add a task to google tasks', load POST /tasks/v1/lists/@default/tasks, and execute it for each action item the agent generated overnight.

Key Endpoints

14 endpoints — the google tasks api exposes the same tasks and task lists that surface inside gmail, google calendar, and the tasks mobile apps.

METHOD

PATH

DESCRIPTION

GET

/tasks/v1/users/@me/lists

List all task lists for the authenticated user

POST

/tasks/v1/users/@me/lists

Create a new task list

GET

/tasks/v1/lists/{tasklist}/tasks

List tasks within a list

POST

/tasks/v1/lists/{tasklist}/tasks

Insert a new task into a list

POST

/tasks/v1/lists/{tasklist}/tasks/{task}/move

Move a task to a new position or under a different parent

POST

/tasks/v1/lists/{tasklist}/clear

Clear all completed tasks from a list

GET

/tasks/v1/users/@me/lists

List all task lists for the authenticated user

POST

/tasks/v1/users/@me/lists

Create a new task list

GET

/tasks/v1/lists/{tasklist}/tasks

List tasks within a list

POST

/tasks/v1/lists/{tasklist}/tasks

Insert a new task into a list

POST

/tasks/v1/lists/{tasklist}/tasks/{task}/move

Move a task to a new position or under a different parent

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

OAuth 2.0 tokens for Google Tasks are stored encrypted in the Jentic vault. The agent calls Tasks operations through Jentic and never holds raw access or refresh tokens.

Intent-based discovery

Agents search 'add a task to google tasks' or 'list my google tasks' and Jentic returns the matching v1 operation with its input schema (tasklist ID, task body, parent and previous fields for ordering).

Time to first call

Direct Tasks API integration: 1-2 days for OAuth, scope handling, and pagination. Through Jentic: under 30 minutes.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Google Calendar API

Tasks can be displayed alongside Calendar events; Calendar events often generate follow-up tasks

Use Calendar to read meetings, then use Tasks to insert follow-up action items derived from those meetings.

Complementary

Gmail API

Convert email threads into actionable Tasks with deep links back to the source message

Use Gmail to fetch emails needing action, then use Tasks to create a task linking back to the message.

Alternative

Google Keep API

Note-taking surface that also supports checkboxes; suited for free-form lists rather than scheduled tasks

Choose Keep for ad-hoc note-style lists; choose Tasks when due dates and completion tracking matter.

FAQs

Specific to using Google Tasks API API through Jentic.

What authentication does the Google Tasks API use?

Google Tasks uses OAuth 2.0 with two scopes — https://www.googleapis.com/auth/tasks for full read/write and https://www.googleapis.com/auth/tasks.readonly for view-only access. Choose the readonly scope when your integration only lists tasks. Through Jentic, the OAuth tokens are stored encrypted and refresh transparently, so the agent never handles raw bearer tokens.

Can I create subtasks with the Google Tasks API?

Yes. Insert a child task with POST /tasks/v1/lists/{tasklist}/tasks and pass the parent parameter set to the parent task's ID, or use the move endpoint with parent and previous parameters to nest an existing task. The Tasks mobile app and Gmail side panel render the resulting hierarchy as nested checkboxes.

What are the rate limits for the Google Tasks API?

The default per-project quota is 50,000 queries per day with a per-user limit of approximately 5 queries per second. Tasks resources are small so most integrations stay well within the daily cap; back off on 429 responses and use the updatedMin parameter on list calls to avoid full re-syncs.

How do I add a task through Jentic?

Search Jentic for 'add a task to google tasks', load the schema for POST /tasks/v1/lists/{tasklist}/tasks, and execute it with the target tasklist ID (use '@default' for the user's primary list) plus the task title and optional due date. Get started at https://app.jentic.com/sign-up.

Is the Google Tasks API free?

Yes, the Google Tasks API is free to use within the standard daily quota. There is no per-call charge — it is part of the Google Workspace and consumer Google account surface, billed only as part of standard Workspace subscriptions where applicable.

Can I clear completed tasks in bulk?

Yes. POST /tasks/v1/lists/{tasklist}/clear deletes every task in the specified list whose status is 'completed' in a single call. This is the most efficient way to archive finished work; cleared tasks are not recoverable through the API so confirm intent before calling.