Google Tasks

Google Tasks

Google Tasks API Model Context Protocol Server.

94
Stars
32
Forks
0
Releases

Overview

Google Tasks MCP Server is an MCP server that integrates with Google Tasks to enable common task management actions via the MCP protocol. It exposes tools for interacting with Google Tasks: search for tasks by a query; list all tasks with optional pagination; create new tasks with a title (required) and optional notes and due date; update an existing task by id and uri with optional title, notes, status (needsAction or completed), and due; delete a task by id and task list; and clear completed tasks from a task list. The server also exposes a Task resource (gtasks:///<task_id>) that represents individual tasks and can be read for details such as title, status, due date, notes, and other metadata. Getting started includes enabling the Google Tasks API, configuring OAuth scopes, and authenticating. There are installation options via Smithery for Claude Desktop and configuration examples to integrate with a desktop app. The server supports building or watching with npm and saves credentials locally during authentication.

Details

Owner
zcaceres
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Search

Search for tasks in Google Tasks. Input: query (string). Returns matching tasks with details.

List

List all tasks in Google Tasks. Optional input: cursor (string) for pagination. Returns a list of all tasks.

Create

Create a new task. Inputs: taskListId (string, optional), title (string, required), notes (string, optional), due (string, optional). Returns creation confirmation.

Update

Update an existing task. Inputs: taskListId (string, optional), id (string, required), uri (string, required), title/notes/status/due (optional). Returns update confirmation.

Delete

Delete a task. Inputs: taskListId (string, required), id (string, required). Returns deletion confirmation.

Clear

Clear completed tasks from a Google Tasks task list. Input: taskListId (string, required). Returns confirmation.

Tasks Resource

Represents individual tasks via the gtasks:///<task_id> URI. Supports reading task details and leveraging the provided tools to list, read, create, update, and delete tasks.

Desktop App Integration & Smithery Installation

Includes authentication flow and guidance for integrating with desktop apps, including Smithery installation for Claude and configuration examples.

Tags

Google TasksMCP ServerTaskssearchlistcreateupdatedeleteclearOAuthSmitheryClaudedesktop app