Overview

Google Tasks MCP provides a bridge between Claude and Google Tasks, allowing the AI to manage your tasks through natural language. The server implements the Model Context Protocol (MCP) specification to enable Claude to interact with Google Tasks API.

Available Tools

The MCP server provides the following tools for interacting with Google Tasks:

search

Search for specific tasks in your Google Tasks lists.

• Input: query (string) - The search term to find matching tasks
• Output: A list of tasks matching the search criteria

list

Retrieve all tasks from your Google Tasks lists.

• Input: cursor (string, optional) - Pagination cursor for large task lists
• Output: A comprehensive list of your tasks

create

Add a new task to Google Tasks.

• Input:
  • taskListId (string, optional) - The ID of the task list to add the task to
  • title (string, required) - The title of the new task
  • notes (string, optional) - Additional notes for the task
  • due (string, optional) - Due date for the task
• Output: Confirmation of task creation with task details

update

Modify an existing task in Google Tasks.

• Input:
  • taskListId (string, optional) - The task list ID
  • id (string, required) - The task ID to update
  • uri (string, required) - The task URI
  • title (string, optional) - New title for the task
  • notes (string, optional) - New notes for the task
  • status (string, optional) - New status ("needsAction" or "completed")
  • due (string, optional) - New due date
• Output: Confirmation of task update with updated details

delete

Remove a task from Google Tasks.

• Input:
  • taskListId (string, required) - The task list ID
  • id (string, required) - The task ID to delete
• Output: Confirmation of task deletion

clear

Remove all completed tasks from a task list.

• Input: taskListId (string, required) - The task list ID to clear
• Output: Confirmation of cleared tasks

Installation

Prerequisites

• Node.js installed on your system
• A Google Cloud project with Google Tasks API enabled
• OAuth credentials for Google Tasks API

Setup Instructions

1. Create a Google Cloud Project

   • Go to the Google Cloud Console
   • Create a new project

2. Enable the Google Tasks API

   • Navigate to Google Workspace API Products
   • Find and enable the Google Tasks API

3. Configure OAuth Consent Screen

   • Go to OAuth Consent Screen
   • Choose "Internal" for testing purposes
   • Add the scope: https://www.googleapis.com/auth/tasks

4. Create OAuth Credentials

   • Navigate to Credentials
   • Create an OAuth Client ID for a "Desktop App"
   • Download the JSON file containing your credentials

5. Install the MCP Server

   • Clone the repository: git clone https://github.com/zcaceres/gtasks-mcp.git
   • Navigate to the project directory: cd gtasks-mcp
   • Install dependencies: npm install
   • Rename your downloaded OAuth credentials file to gcp-oauth.keys.json and place it in the root directory
   • Build the server: npm run build

6. Authenticate with Google

   • Run: npm run start auth
   • Complete the authentication flow in your browser
   • Credentials will be saved as .gdrive-server-credentials.json in the project root

Installation via Smithery

For an automated installation with Claude Desktop:

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

Manual Integration with Claude Desktop

To manually configure the MCP server with Claude Desktop:

1. Locate your Claude Desktop configuration file
2. Add the following configuration (replace the path with your actual path):

{
  "mcpServers": {
    "gtasks": {
      "command": "/path/to/node",
      "args": [
        "/absolute/path/to/gtasks-mcp/dist/index.js"
      ]
    }
  }
}

Usage

Once installed and configured, you can use Claude to interact with your Google Tasks through natural language. For example:

• "Show me all my tasks"
• "Create a new task to buy groceries due tomorrow"
• "Mark my 'call mom' task as completed"
• "Delete the task about the dentist appointment"
• "Search for tasks related to work"

Claude will use the appropriate tools to interact with your Google Tasks account based on your requests.