Google Tasks MCP Server

Google Tasks MCP Server

Manage Google Tasks directly via Claude using an MCP bridge.

26
Stars
14
Forks
26
Watchers
0
Issues
Google Tasks MCP Server acts as a Model Context Protocol (MCP) server enabling seamless integration between Claude and Google Tasks. It facilitates task list and task management operations such as listing, creating, updating, deleting, moving, and marking tasks as completed. Users can interact with their Google Tasks through Claude Desktop, streamlining workflow automation and productivity. Installation can be performed via Smithery or manually, with OAuth-based authentication for secure access.

Key Features

List all Google task lists
Get details about specific task lists
Create, update, and delete task lists
List, create, update, and delete individual tasks
Mark tasks as completed
Move and reorder tasks
Clear all completed tasks from a list
OAuth-based authentication flow
Smithery-based automated installation
Desktop integration with Claude

Use Cases

Manage personal or work tasks through Claude and Google Tasks integration
Automate task creation and completion from AI-driven prompts
Synchronize task updates between Claude Desktop and Google Tasks
Allow AI to help organize and prioritize tasks using standardized protocols
Batch clear completed tasks for efficient list management
Programmatically reorder and structure Google Tasks from within Claude
Enable secure access to Google Tasks via OAuth authentication
Integrate Google Tasks functionality into productivity workflows
Enhance AI agent capabilities with direct control over Google Task actions
Use model context management to interact with third-party task services

README

MseeP.ai Security Assessment Badge

Google Tasks MCP Server

Trust Score

smithery badge

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/oauth2callback" 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:
json
{
  "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:

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

Manual Installation

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

Star History

Star History Chart

Repository Owner

Repository Details

Language TypeScript
Default Branch main
Size 1,587 KB
Contributors 6
License MIT License
MCP Verified Nov 11, 2025

Programming Languages

TypeScript
96.96%
Dockerfile
3.04%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Google Tasks MCP Server

    Google Tasks MCP Server

    Integrate and manage Google Tasks via standardized MCP tools and resources.

    Google Tasks MCP Server integrates seamlessly with Google Tasks, providing standardized tools for listing, searching, creating, updating, and deleting tasks. Following the Model Context Protocol, it exposes task resources and actions in a way that can be easily integrated with MCP-driven applications, including desktop AI assistants. The server supports OAuth authentication, context-driven task manipulation, and automated integration with platforms like Smithery and Claude Desktop.

    • 91
    • MCP
    • zcaceres/gtasks-mcp
  • Google Workspace MCP Server

    Google Workspace MCP Server

    A secure MCP server bridging Google Workspace and AI clients.

    Google Workspace MCP Server implements the Model Context Protocol to enable secure integration between Google Workspace services—such as Gmail, Calendar, and Drive—and any MCP-compatible AI client. It allows users to read, search, create, update, and delete Google Calendar events, emails, and Drive files directly through an AI agent interface. The tool ensures authentication via Google OAuth and provides a seamless setup process for both server and client sides. This makes it easier for AI-powered workflows to interact with Google Workspace data securely and contextually.

    • 20
    • MCP
    • giuseppe-coco/Google-Workspace-MCP-Server
  • Google Calendar MCP Server

    Google Calendar MCP Server

    MCP-compliant server enabling Google Calendar integration with Claude Desktop.

    Google Calendar MCP Server provides a Model Context Protocol server implementation for seamless integration between Claude Desktop and Google Calendar. It enables natural language-based scheduling, creation, updating, and deletion of calendar events by handling OAuth2 authentication and offering standardized tool interfaces. The server employs TypeScript, leverages the MCP SDK, and ensures secure token handling with AES-256-GCM encryption. Robust schema validation and environment-based configuration enable secure, reliable, and flexible calendar management.

    • 53
    • MCP
    • takumi0706/google-calendar-mcp
  • MCP Server for Google Tag Manager

    MCP Server for Google Tag Manager

    Remote MCP server enabling Google Tag Manager integration with AI clients.

    MCP Server for Google Tag Manager enables remote MCP connections with built-in Google OAuth, creating an interface to the Google Tag Manager API. It facilitates secure authentication and streamlined access for AI tools like Claude Desktop and Cursor AI. Developers can quickly configure their MCP clients for seamless integration and manage credentials with ease. Tools and workflows become accessible once authenticated, enhancing contextual interaction and automation through Google Tag Manager.

    • 70
    • MCP
    • stape-io/google-tag-manager-mcp-server
  • Google Workspace MCP Server

    Google Workspace MCP Server

    Full natural language control of Google Workspace through the Model Context Protocol.

    Google Workspace MCP Server enables comprehensive natural language interaction with Google services such as Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, and Chat via any MCP-compatible client or AI assistant. It supports both single-user and secure multi-user OAuth 2.1 authentication, providing a production-ready backend for custom apps. Built on FastMCP, it delivers high performance and advanced context handling, offering deep integration with the entire Google Workspace suite.

    • 890
    • MCP
    • taylorwilsdon/google_workspace_mcp
  • Google Ads MCP Server

    Google Ads MCP Server

    Seamlessly connect Google Ads API to MCP clients with automatic authentication and querying.

    Google Ads MCP Server is a FastMCP-powered Model Context Protocol server designed to integrate Google Ads API with MCP clients such as Claude Desktop. It provides automatic OAuth 2.0 authentication, smart token management, GAQL query execution, and keyword research tools. The server enables users to manage accounts, run advanced queries, and generate keyword ideas while maintaining secure local token storage. Optimized for one-click setup, it offers robust features for advertisers and developers looking to leverage Google Ads data with MCP-compatible tools.

    • 76
    • MCP
    • gomarble-ai/google-ads-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results