MewCP Google Tasks MCP

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.

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

- 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

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.

{ 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; }

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.

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

{ 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; }

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

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

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

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

{ 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; }

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.

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

{ 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; }

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

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

{ 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; }

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.

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

{ 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 a brand new task list. Returns the created task list with its assigned ID and metadata.

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

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

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.

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

{ 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 all the tasks present in the specific task list. Returns task IDs, titles, statuses, and other metadata for all tasks in the list.

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

{ 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 the details or metadata of a specific task list. Returns the task list ID, title, and last updated timestamp.

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

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

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.

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

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

Every tool returns the same top-level envelope. Onlydatavaries 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—truewhen it is safe to retry (rate limit, network error, 503).falsefor auth, not-found, and other non-transient errors.
- retry_after_seconds— seconds to wait before retrying; present only whenretriableistrueand the upstream specifies a delay.
- error.code— machine-readable string:NOT_FOUND(get_task_by_namefound 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).

- tasklist_id— The unique ID of a Google Tasks list. Obtain it fromlist_task_lists,create_tasklist, or any task list response'sidfield. 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 fromlist_tasks,add_task, or any task response'sidfield.
- next_page_token— Returned bylist_task_listsandlist_taskswhen 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.

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

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

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

- Cause:API key not provided in request headers or incorrect format
- Solution:
- VerifyAuthorization: Bearer YOUR_API_KEYandX-Mewcp-Credential-Id: CREDENTIAL-IDheaders are present
- Check API key is active in your MewCP account

- Cause:API calls have exceeded your request limits
- Solution:
- Check credit usage in your Curious Layer dashboard
- Upgrade to a paid plan or add credits for higher limits
- Contact support for credit adjustments

- Cause:No Google Tasks credential linked to your account
- Solution:
- Go toCredentialsin your MewCP dashboard
- Connect your Google account via OAuth
- Retry the request with the correctX-Mewcp-Credential-Idheader

- Cause:JSON payload is invalid or missing required fields
- Solution:
- Validate JSON syntax before sending
- Ensure all required tool parameters are included
- Check parameter types match expected values

- Cause:Incorrect server name in the API endpoint
- Solution:
- Verify endpoint format:{server-name}/mcp/{tool-name}
- Use correct server name from documentation
- Check available servers in your Curious Layer account

- Cause:Upstream Google Tasks API returned an error
- Solution:
- Check Google service status atGoogle Workspace Status Page
- Verify your credential has the required Google Tasks permissions
- Review the error message for specific details

- 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

Interact with task, doc, and project data in Dart, an AI-native project management tool