Google Tasks MCP Server

Name: Google Tasks MCP Server
Author: zcaceres

@zcaceres

Repository

About Google Tasks MCP Server

A Google Tasks Model Context Protocol Server for Claude

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gtasks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@zcaceres/gtasks",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

Search for tasks in Google Tasks

List all tasks in Google Tasks

Create a new task in Google Tasks

Update an existing task in Google Tasks

Delete a task in Google Tasks

Clear completed tasks from a Google Tasks task list

Overview

What is Google Tasks MCP Server?

Google Tasks MCP Server is an MCP server that integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks. It is built for developers and users who want to manage Google Tasks through an AI assistant or any MCP-compatible client.

How to use Google Tasks MCP Server?

Create a Google Cloud project, enable the Google Tasks API, configure an OAuth consent screen (add scope https://www.googleapis.com/auth/tasks), and create an OAuth Client ID for a Desktop App. 2. Download the OAuth keys JSON, rename it to gcp-oauth.keys.json, and place it in the repository root. 3. Build the server with npm run build or npm run watch. 4. Run authentication with npm run start auth to complete the OAuth flow and save credentials. 5. Configure the server in your desktop app (e.g., Claude) using the built dist/index.js file.

Key features of Google Tasks MCP Server

Search tasks by query string
List all tasks with optional cursor pagination
Create tasks with title, notes, and due date
Update task title, notes, status, and due date
Delete tasks by task list ID and task ID
Clear completed tasks from a task list

Use cases of Google Tasks MCP Server

Manage personal task lists through an AI chat interface
Automate task creation, updates, and deletions based on LLM instructions
Search and retrieve tasks quickly using natural language queries
Integrate Google Tasks into MCP‑enabled desktop applications

FAQ from Google Tasks MCP Server

What permissions (OAuth scopes) does it require?

It requires the OAuth scope https://www.googleapis.com/auth/tasks to read and write tasks.

How do I authenticate with Google Tasks?

Run the server with the auth argument (npm run start auth). This opens a browser authentication flow; after completion, credentials are saved as .gdrive-server-credentials.json in the repository root.