Google Tasks

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/girmmy-google-tasks

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Nov 2, 2026.

Tools

4 read · 7 write · 3 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• google_tasks_clear_completed_tasksClear Completed Google Taskscan change or delete data

  Clear all completed tasks from a task list. Cleared tasks are hidden from the default view (they become 'hidden' and won't reappear unless show_hidden=true is passed to google_tasks_list_tasks). This does not delete incomplete tasks. Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') Returns a confirmation message. Examples: - Use when: "Clear out everything I've already finished on my to-do list"

• google_tasks_complete_taskComplete Google Task

  Mark a task as completed. Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') - task_id (string): ID of the task to complete - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the updated task with status='completed' and a completion timestamp. Examples: - Use when: "Mark 'buy milk' as done"

• google_tasks_create_taskCreate Google Task

  Create a new task in a Google Task list. Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') - title (string): Task title - notes (string, optional): Free-text description - due (RFC 3339 string, optional): Due date, e.g. '2026-09-10T00:00:00Z' (Google Tasks stores date only, not time) - parent_task_id (string, optional): Create as a subtask of this task - previous_task_id (string, optional): Place this task after the given task in list order - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the newly created…

• google_tasks_create_tasklistCreate Google Task List

  Create a new Google Task list (a new top-level container, e.g. "Work" or "Groceries"). Args: - title (string): Title for the new list - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the newly created task list's id and title. Use the returned id as tasklist_id in other tools. Examples: - Use when: "Make me a new task list called Home Renovation" - Don't use when: You just want to add a task to an existing list (use google_tasks_create_task instead).

• google_tasks_delete_taskDelete Google Taskcan change or delete data

  Permanently delete a single task. This cannot be undone. Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') - task_id (string): ID of the task to delete Returns a confirmation message. Don't use when: You want to remove all completed tasks at once — use google_tasks_clear_completed_tasks instead. Error Handling: - Returns "Error: Not found (404)" if task_id doesn't exist.

• google_tasks_delete_tasklistDelete Google Task Listcan change or delete data

  Permanently delete a Google Task list AND all tasks in it. This cannot be undone and cannot target the '@default' list. Args: - tasklist_id (string): ID of the task list to delete (must not be '@default') Returns a confirmation message. Error Handling: - Returns "Error: Invalid request (400)" if you try to delete the default list. - Returns "Error: Not found (404)" if tasklist_id doesn't exist.

• google_tasks_get_taskGet Google Taskread-only

  Fetch full details for a single task by ID. Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') - task_id (string): ID of the task (from google_tasks_list_tasks) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the task's title, status, due date, notes, completion time, and parent (if a subtask). Error Handling: - Returns "Error: Not found (404)" if task_id doesn't exist in that list.

• google_tasks_get_tasklistGet Google Task Listread-only

  Fetch metadata for a single Google Task list by ID. Args: - tasklist_id (string): ID of the task list (from google_tasks_list_tasklists) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the task list's id, title, and last-updated time. Error Handling: - Returns "Error: Not found (404)" if the tasklist_id doesn't exist.

• google_tasks_list_tasklistsList Google Task Listsread-only

  List all of the user's Google Task lists (the top-level containers tasks live in, shown as separate lists in the Google Tasks UI). Args: - limit (number): Max task lists to return, 1-100 (default: 20) - page_token (string, optional): Pagination token from a previous response's next_page_token - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns task list id + title for each list, plus pagination info (has_more, next_page_token). Examples: - Use when: "What task lists do I have?" or before creating/looking up a task, to find its tasklist_id. Error Han…

• google_tasks_list_tasksList Google Tasksread-only

  List tasks in a Google Task list, optionally filtered by due date or last-updated time. Args: - tasklist_id (string): ID of the task list, or '@default' for the default list (default: '@default') - limit (number): Max tasks to return, 1-100 (default: 20) - page_token (string, optional): Pagination token from a previous response - show_completed (boolean): Include completed tasks (default: true) - show_deleted (boolean): Include deleted tasks (default: false) - show_hidden (boolean): Include hidden tasks, i.e. completed tasks that were cleared (default: false) - due_min / due_max…

• google_tasks_move_taskMove/Reorder Google Task

  Reorder a task within its list, nest/un-nest it under a parent task, or move it to a different task list. Args: - tasklist_id (string): ID of the task's current task list, or '@default' (default: '@default') - task_id (string): ID of the task to move - parent_task_id (string, optional): New parent task ID, to nest as a subtask - previous_task_id (string, optional): Place after this task in the new position - destination_tasklist_id (string, optional): Move the task into a different task list entirely - response_format ('markdown' | 'json'): Output format (default: 'markdown') Ret…

• google_tasks_reopen_taskReopen Google Task

  Mark a completed task as not-done (status back to 'needsAction'). Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') - task_id (string): ID of the task to reopen - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the updated task with status='needsAction'.

• google_tasks_update_taskUpdate Google Task

  Update an existing task's title, notes, due date, and/or status. Only fields you provide are changed. Args: - tasklist_id (string): ID of the task list, or '@default' (default: '@default') - task_id (string): ID of the task to update - title (string, optional): New title - notes (string, optional): New notes (pass '' to clear) - due (RFC 3339 string or null, optional): New due date, or null to clear it - status ('needsAction' | 'completed', optional): New status — prefer google_tasks_complete_task/reopen_task instead - response_format ('markdown' | 'json'): Output format (defaul…

• google_tasks_update_tasklistRename Google Task List

  Rename an existing Google Task list. Args: - tasklist_id (string): ID of the task list to rename - title (string): New title - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns the updated task list. Error Handling: - Returns "Error: Not found (404)" if tasklist_id doesn't exist.

Signals

Stars

2

Forks

0

Open issues

0

Weekly downloads

39

Last commit

Sep 10, 2026 (1 month ago)

Last release

Sep 10, 2026 (1 month ago)

Last package publish

Sep 10, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.girmmy/google-tasks

Version

1.0.3

Auth

No auth

Packages

npm @girmmy/google-tasks-mcp-server

License

MIT

Repository

github.com/girmmy/google-tasks-mcp-server

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql