Gtasks-mcp Server

A Model Context Protocol (MCP) server for Google Tasks. Manage task lists and tasks through natural language in Claude Desktop and other MCP clients.

Local serverstdioMIT

What is the Gtasks-mcp Server?

gtasks-mcp is an MCP project maintained in the alvinjchoi/gtasks-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for Google Tasks. Manage task lists and tasks through natural language in Claude Desktop and other MCP clients”. Read the project documentation for the complete scope.

Installation

The documented npm package is @alvincrave/gtasks-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
search	Search tasks by title/notes. Optional taskListId.
list	List tasks (all lists, or one via taskListId). Fully paginated.
list_task_lists	List task list names and IDs.
list_with_tree	Tree view for one list (parent/child, position order).
move	Reorder, nest/un-nest, or move across lists.
create	Create a task (title required; optional notes/due/taskListId).
update	Patch a task (only provided fields change).
delete	Delete a task.
clear	Clear completed tasks from a list.

How to install the Gtasks-mcp Server

{
  "mcpServers": {
    "gtasks": {
      "command": "npx",
      "args": [
        "-y",
        "@alvincrave/gtasks-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "YOUR_GOOGLE_CLIENT_SECRET",
        "GOOGLE_REFRESH_TOKEN": "YOUR_GOOGLE_REFRESH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
GOOGLE_CLIENT_ID	Declared in the maintainer’s client configuration.	Check documentation
GOOGLE_CLIENT_SECRET	Declared in the maintainer’s client configuration.	Check documentation
GOOGLE_REFRESH_TOKEN	Declared in the maintainer’s client configuration.	Check documentation