Google Tasks MCP Server

Developer ToolsTypeScript

Manage your Google Tasks directly through Claude

Available Tools

authenticate

Get an authorization URL to authenticate with Google Tasks

set-auth-code

Complete the authentication process with the code received from Google

list-tasklists

List all your task lists

get-tasklist

Get details about a specific task list

create-tasklist

Create a new task list

update-tasklist

Update an existing task list

delete-tasklist

Delete a task list

list-tasks

List all tasks in a task list

get-task

Get details about a specific task

create-task

Create a new task

update-task

Update an existing task

delete-task

Delete a task

complete-task

Mark a task as completed

move-task

Move a task (reorder or change parent)

clear-completed-tasks

Clear all completed tasks from a list

This integration provides a seamless bridge between Claude and Google Tasks, allowing you to manage your task lists and individual tasks without leaving your Claude interface. You can create, update, delete, and organize tasks and task lists through simple commands. With Google Tasks integration, you can maintain your productivity workflow entirely within Claude. The MCP server handles all the authentication and API interactions with Google, providing you with a streamlined experience for task management.

Overview

The Google Tasks integration allows Claude to interact with your Google Tasks account, enabling you to manage your to-do lists directly through the Claude interface. This integration provides a comprehensive set of tools for creating, updating, and organizing both task lists and individual tasks.

Setup Instructions

1. Create a Google Cloud Project

Before using this integration, you need to set up a Google Cloud Project with the Tasks API enabled:

Go to the Google Cloud Console
Create a new project
Navigate to "APIs & Services" > "Library"
Search for "Google Tasks API" and enable it
Go to "APIs & Services" > "Credentials"
Click "Create Credentials" > "OAuth Client ID"
Configure the OAuth consent screen (External is fine for personal use)
For Application Type, select "Web application"
Add "http://localhost:3000" as an authorized redirect URI
Create the client ID and secret and note them down for later use

2. Configure Claude for Desktop

Install Claude for Desktop if you haven't already
Open the Claude configuration file:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the Google Tasks MCP server configuration as shown in the installation section below
Replace the placeholder values with your actual Google Cloud credentials
Restart Claude for Desktop

3. Authentication Process

When you first use the Google Tasks integration:

Use the authenticate tool to get an authorization URL
Visit the URL in your browser and sign in with your Google account
After authorizing, you'll receive a code on the browser page
Use the set-auth-code tool with this code to complete authentication
You can now use all other tools to interact with Google Tasks

Note that your authentication is session-based and will be lost when you restart the server. You'll need to re-authenticate each time.

Usage Examples

Here are some examples of how to use the Google Tasks integration:

Managing Task Lists

To see all your task lists: "Show me all my task lists"
To create a new task list: "Create a new task list called 'Work Projects'"
To update a task list: "Rename my 'Work Projects' task list to 'Priority Projects'"
To delete a task list: "Delete my 'Old Tasks' task list"

Managing Tasks

To see tasks in a list: "Show me all tasks in my 'Shopping' list"
To create a task: "Add 'Buy milk' to my 'Shopping' list"
To update a task: "Change 'Buy milk' to 'Buy organic milk' in my 'Shopping' list"
To mark a task as complete: "Mark 'Buy milk' as completed in my 'Shopping' list"
To delete a task: "Delete the 'Call mom' task from my 'Personal' list"
To clear completed tasks: "Clear all completed tasks from my 'Shopping' list"

Requirements

Node.js 14+
Claude for Desktop (latest version)
Google Cloud Project with Tasks API enabled