arpitbatra123_mcp_googletasks

arpitbatra123_mcp_googletasks

by arpitbatra123
An MCP server that integrates Claude with Google Tasks for managing task lists and tasks directly through Claude.

Google Tasks Integration for Claude

Overview

The Google Tasks MCP Server is a Model Context Protocol (MCP) server that bridges Claude with Google Tasks, enabling seamless management of task lists and tasks directly through Claude. This project leverages Claude's capabilities to interact with Google Tasks API, providing a streamlined workflow for task management.

Features

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:
  3. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  4. Windows: %APPDATA%\Claude\claude_desktop_config.json
  5. 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

  1. Install dependencies:
npm install
  1. Build the server:
npm run build
  1. 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: 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

Screenshot

License

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

Features & Capabilities

Categories
mcp_server model_context_protocol google_tasks claude api_integration nodejs typescript

Implementation Details

View on GitHub

Stats

0 Views
3 GitHub Stars

Repository Info

arpitbatra123 Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI