Google Tasks MCP Server

This MCP server integrates with Google Tasks, enabling listing, reading, searching, creating, updating, and deleting tasks. It provides a set of tools and resources for interacting with Google Tasks programmatically.

Components

Tools

• search: Searches tasks using a query string.
• list: Lists all tasks with optional pagination using a cursor.
• create: Creates a new task, requiring a title and accepting optional task list ID, notes, and due date.
• update: Updates an existing task, requiring task list ID, task ID, and URI, and accepting optional title, notes, status ("needsAction" or "completed"), and due date.
• delete: Deletes a task, requiring task list ID and task ID.
• clear: Clears completed tasks from a specified task list.

Resources

• Tasks (gtasks:///<task_id>): Represents individual tasks, supporting read operations for details like title, status, due date, and notes. Supports listing, reading, creating, updating, and deleting using the provided tools.

Getting started

1. Create a Google Cloud project and enable the Google Tasks API.
2. Configure an OAuth consent screen and create an OAuth Client ID for a "Desktop App."
3. Download the client's OAuth keys, rename it to gcp-oauth.keys.json, and place it in the root directory.
4. Build the server using npm run build or npm run watch.

Installing via Smithery

Install automatically via Smithery:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

Authentication

1. Run the server with the auth argument: npm run start auth.
2. Complete the authentication process in your browser.
3. Credentials will be saved as .gdrive-server-credentials.json in the root directory.

Usage with Desktop App

Integrate with the desktop app by adding the server configuration.