mewcp-google-tasks

Create, track, and manage Google Tasks and task lists — directly from your AI workflows.

A Model Context Protocol (MCP) server that exposes Google Tasks' API for creating, listing, updating, completing, and deleting tasks and task lists.

Overview

The Google Tasks MCP Server provides full programmatic access to Google Tasks through a stateless, multi-tenant interface:

• List, create, update, and delete task lists
• List, create, look up, update, complete, and delete individual tasks
• Every mutating tool that overwrites state (`update_task`, `update_tasklist`) returns both the before and after state of the resource

Perfect for:

• Automating to-do list management and task tracking from AI agents
• Building assistants that can create and complete tasks on a user's behalf
• Integrating Google Tasks actions into LLM-powered pipelines and reminders

Tools

list_task_lists — List all task lists

List all task lists accessible by the user. Returns task list IDs, titles, and metadata. Use the task list ID from the response to access tasks within a list.

Inputs:

(none)

Output `data` schema:

{
  count: number;
  tasklists: {
    id: string;
    title: string | null;
    updated: string | null;
    etag: string | null;
    kind: string | null;
    selfLink: string | null;
  }[];
  next_page_token: string | null;
}

add_task — Create a new task

Create a new task in a specific task list. Provide the task list ID, title, and optional notes and due date. Returns the created task with its assigned ID.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `title` (string, required) — The title of the new task.
- `notes` (string, optional, default: "") — Optional details or description for the task.
- `due` (string, optional, default: "") — Optional due date. MUST be an RFC 3339 timestamp (e.g., '2026-06-17T00:00:00.000Z').

Output `data` schema:

{
  id: string;
  title: string | null;
  notes: string | null;
  due: string | null;
  status: string | null;
  position: string | null;
  parent: string | null;
  links: { [key: string]: any }[] | null;
  webViewLink: string | null;
  hidden: boolean | null;
  completed: string | null;
  deleted: boolean | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

get_task — Get a task's details

Gets the detail of a specific task from the task list. Returns the full task object including title, notes, due date, status, and position.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `task_id` (string, required) — The unique ID of the Google Task

Output `data` schema:

{
  id: string;
  title: string | null;
  notes: string | null;
  due: string | null;
  status: string | null;
  position: string | null;
  parent: string | null;
  links: { [key: string]: any }[] | null;
  webViewLink: string | null;
  hidden: boolean | null;
  completed: string | null;
  deleted: boolean | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

get_task_by_name — Find a task by title

Get the task details from the name of the task. Searches a task list for a task by its title and returns the matching task details.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `task_title` (string, required) — The title of the task to search for.

Output `data` schema:

{
  id: string;
  title: string | null;
  notes: string | null;
  due: string | null;
  status: string | null;
  position: string | null;
  parent: string | null;
  links: { [key: string]: any }[] | null;
  webViewLink: string | null;
  hidden: boolean | null;
  completed: string | null;
  deleted: boolean | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

delete_task — Permanently delete a task (destructive)

DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently deletes a specific task from the task list. This action is irreversible — the deleted task and all its data cannot be recovered. NEVER call this tool autonomously or as part of an automated flow. You MUST stop, tell the user exactly what will be deleted and that it is permanent, and wait for their explicit written confirmation before proceeding.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `task_id` (string, required) — The unique ID of the Google Task

Output `data` schema:

{
  id: string;
  title: string | null;
  notes: string | null;
  due: string | null;
  status: string | null;
  position: string | null;
  parent: string | null;
  links: { [key: string]: any }[] | null;
  webViewLink: string | null;
  hidden: boolean | null;
  completed: string | null;
  deleted: boolean | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

complete_task — Mark a task as completed

Mark a specific task as completed from the task list. Sets the task status to 'completed'. Returns the updated task object.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `task_id` (string, required) — The unique ID of the Google Task

Output `data` schema:

{
  id: string;
  title: string | null;
  notes: string | null;
  due: string | null;
  status: string | null;
  position: string | null;
  parent: string | null;
  links: { [key: string]: any }[] | null;
  webViewLink: string | null;
  hidden: boolean | null;
  completed: string | null;
  deleted: boolean | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

update_task — Update an existing task

Updates an existing task. Only the fields you provide are changed — others keep their current value. NOTE: this overwrites the current field values — the original state is not stored after the call. The response includes both the before and after state so you have a full record of what changed.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `task_id` (string, required) — The unique ID of the Google Task
- `task_title` (string, required) — The title of the task.
- `notes` (string, optional, default: "") — Optional details or description for the task.
- `due` (string, optional, default: "") — Optional due date. MUST be an RFC 3339 timestamp (e.g., '2026-06-17T00:00:00.000Z').

Output `data` schema:

{
  before: {
    id: string;
    title: string | null;
    notes: string | null;
    due: string | null;
    status: string | null;
    position: string | null;
    parent: string | null;
    links: { [key: string]: any }[] | null;
    webViewLink: string | null;
    hidden: boolean | null;
    completed: string | null;
    deleted: boolean | null;
    etag: string | null;
    kind: string | null;
    selfLink: string | null;
  };
  after: {
    id: string;
    title: string | null;
    notes: string | null;
    due: string | null;
    status: string | null;
    position: string | null;
    parent: string | null;
    links: { [key: string]: any }[] | null;
    webViewLink: string | null;
    hidden: boolean | null;
    completed: string | null;
    deleted: boolean | null;
    etag: string | null;
    kind: string | null;
    selfLink: string | null;
  };
}

create_tasklist — Create a new task list

Create a brand new task list. Returns the created task list with its assigned ID and metadata.

Inputs:

- `tasklist_name` (string, required) — The name of the Google Tasks list.

Output `data` schema:

{
  id: string;
  title: string | null;
  updated: string | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

update_tasklist — Rename an existing task list

Updates the name of a specific task list. The response includes both the before and after state so you have a full record of what changed.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.
- `title` (string, required) — The title or name of the Google Tasks list

Output `data` schema:

{
  before: {
    id: string;
    title: string | null;
    updated: string | null;
    etag: string | null;
    kind: string | null;
    selfLink: string | null;
  };
  after: {
    id: string;
    title: string | null;
    updated: string | null;
    etag: string | null;
    kind: string | null;
    selfLink: string | null;
  };
}

list_tasks — List all tasks in a task list

List all the tasks present in the specific task list. Returns task IDs, titles, statuses, and other metadata for all tasks in the list.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.

Output `data` schema:

{
  count: number;
  tasks: {
    id: string;
    title: string | null;
    notes: string | null;
    due: string | null;
    status: string | null;
    position: string | null;
    parent: string | null;
    links: { [key: string]: any }[] | null;
    webViewLink: string | null;
    hidden: boolean | null;
    completed: string | null;
    deleted: boolean | null;
    etag: string | null;
    kind: string | null;
    selfLink: string | null;
  }[];
  next_page_token: string | null;
}

get_tasklist — Get a task list's details

Get the details or metadata of a specific task list. Returns the task list ID, title, and last updated timestamp.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.

Output `data` schema:

{
  id: string;
  title: string | null;
  updated: string | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

delete_tasklist — Permanently delete a task list (destructive)

DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently deletes an entire task list with all tasks in it. This action is irreversible — the task list and all its tasks cannot be recovered. NEVER call this tool autonomously or as part of an automated flow. You MUST stop, tell the user exactly what will be deleted and that it is permanent, and wait for their explicit written confirmation before proceeding.

Inputs:

- `tasklist_id` (string, required) — The unique ID of the Google Tasks list.

Output `data` schema:

{
  id: string;
  title: string | null;
  updated: string | null;
  etag: string | null;
  kind: string | null;
  selfLink: string | null;
}

API Parameters Reference

Response Envelope

Every tool returns the same top-level envelope. Only `data` varies per tool.

// Success
{
  "success": true,
  "statusCode": 200,
  "retriable": false,
  "retry_after_seconds": null,
  "error": null,
  "data": { ... }
}

// Error
{
  "success": false,
  "statusCode": 404,
  "retriable": false,
  "retry_after_seconds": null,
  "error": { "code": "NOT_FOUND", "message": "No task found with the title {task_title}", "details": null },
  "data": null
}

• `retriable` — `true` when it is safe to retry (rate limit, network error, 503). `false` for auth, not-found, and other non-transient errors.
• `retry_after_seconds` — seconds to wait before retrying; present only when `retriable` is `true` and the upstream specifies a delay.
• `error.code` — machine-readable string: `NOT_FOUND` (`get_task_by_name` found no match), `AUTH_ERROR` (no OAuth access token available), `UPSTREAM_ERROR` (the Google Tasks API returned an HTTP error), `SERVER_ERROR` (unexpected server-side failure).

Common Parameters

• `tasklist_id` — The unique ID of a Google Tasks list. Obtain it from `list_task_lists`, `create_tasklist`, or any task list response's `id` field. Required by every task-level and task-list-level tool.
• `task_id` — The unique ID of a Google Task within a task list. Obtain it from `list_tasks`, `add_task`, or any task response's `id` field.
• `next_page_token` — Returned by `list_task_lists` and `list_tasks` when the underlying Google Tasks API indicates more results exist. This server currently passes through a single page from the upstream API and does not expose an input parameter to request subsequent pages.

Resource Formats

Task List ID (`tasklist_id`):

Opaque identifier assigned by the Google Tasks API, or the literal value `@default` for the user's default task list.
Example: MDAxMjM0NTY3ODkwMTIzNDU2Nzo6MA

Task ID (`task_id`):

Opaque identifier assigned by the Google Tasks API when a task is created.
Example: MTIzNDU2Nzg5MDEyMzQ1Njc4OTA

Due Date (`due`):

RFC 3339 timestamp.
Example: 2026-06-17T00:00:00.000Z

Troubleshooting

Missing or Invalid Headers

• Cause: API key not provided in request headers or incorrect format
• Solution:

1. Verify `Authorization: Bearer YOUR_API_KEY` and `X-Mewcp-Credential-Id: CREDENTIAL-ID` headers are present

2. Check API key is active in your MewCP account

Insufficient Credits

• Cause: API calls have exceeded your request limits
• Solution:

1. Check credit usage in your Curious Layer dashboard

2. Upgrade to a paid plan or add credits for higher limits

3. Contact support for credit adjustments

Credential Not Connected

• Cause: No Google Tasks credential linked to your account
• Solution:

1. Go to Credentials in your MewCP dashboard

2. Connect your Google account via OAuth

3. Retry the request with the correct `X-Mewcp-Credential-Id` header

Malformed Request Payload

• Cause: JSON payload is invalid or missing required fields
• Solution:

1. Validate JSON syntax before sending

2. Ensure all required tool parameters are included

3. Check parameter types match expected values

Server Not Found

• Cause: Incorrect server name in the API endpoint
• Solution:

1. Verify endpoint format: `{server-name}/mcp/{tool-name}`

2. Use correct server name from documentation

3. Check available servers in your Curious Layer account

Google Tasks API Error

• Cause: Upstream Google Tasks API returned an error
• Solution:

1. Check Google service status at Google Workspace Status Page

2. Verify your credential has the required Google Tasks permissions

3. Review the error message for specific details

Resources

• **Google Tasks API Documentation** — Official API reference
• **Google Tasks API Reference** — Complete endpoint reference
• **FastMCP Docs** — FastMCP specification
• **FastMCP Credentials** — FastMCP Credentials package for credential handling