What is Mcp Googletasks

mcp-googletasks is an MCP server that acts as a bridge between Claude and Google Tasks, enabling users to manage their task lists and tasks directly through Claude.

Use cases

Use cases include managing personal to-do lists, coordinating team tasks in projects, and automating task updates through Claude.

How to use

To use mcp-googletasks, set up a Google Cloud project, enable the Google Tasks API, create OAuth credentials, and configure Claude for Desktop with the necessary settings.

Key features

Key features include task list management (listing, creating, updating, and deleting task lists) and task management (listing, creating, updating, deleting, completing, moving tasks, and clearing completed tasks).

Where to use

mcp-googletasks can be used in personal productivity, project management, and any context where task management is required.

Google Tasks MCP Server

This Model Context Protocol (MCP) server provides a bridge between Claude and Google Tasks, allowing you to manage your task lists and tasks directly through Claude.

Note: All ( bar some edits ) code in this project was “vibe coded” - generated with Claude with instructions from me.

Features

This MCP server provides the following functionality:

Task List Management

• 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

Task Management

• 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

Setup Instructions

1. Create Google Cloud Project & Enable API

1. Go to the Google Cloud Console
2. Create a new project
3. Navigate to “APIs & Services” > “Library”
4. Search for “Google Tasks API” and enable it
5. Go to “APIs & Services” > “Credentials”
6. Click “Create Credentials” > “OAuth Client ID”
7. Configure the OAuth consent screen (External is fine for personal use)
8. For Application Type, select “Web application”
9. Add “http://localhost:3000” as an authorized redirect URI
10. Create the client ID and secret

2. Configure Claude for Desktop

1. Install Claude for Desktop
2. Open the Claude configuration file:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Add the Google Tasks MCP server configuration:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": [
        "/path/to/google-tasks-mcp/build/index.js"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
      }
    }
  }
}

Replace the path and credentials with your own values.

3. Build and Run the Server

Installing via Smithery

To install Google Tasks Integration Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @arpitbatra123/mcp-googletasks --client claude

Manual Installation

1. Install dependencies:

npm install

2. Build the server:

npm run build

3. Restart Claude for Desktop

Authentication Flow

When you first use the Google Tasks MCP server:

1. Use the authenticate tool to get an authorization URL
2. Visit the URL in your browser and sign in with your Google account
3. After authorizing, you’ll receive a code on the browser page
4. Use the set-auth-code tool with this code to complete authentication
5. 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.

Requirements

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

Screenshot

License

This project is for demonstration purposes only. Use at your own risk.