Google Tasks MCP Server

Google Tasks MCP Server

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

View on GitHub
91
Stars
32
Forks
91
Watchers
14
Issues
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.

Key Features

Standardized MCP tools for Google Tasks operations
Search, list, create, update, and delete tasks
Resource access for individual task details
OAuth-based secure authentication flow
Pagination support for task lists
Integration with Smithery and Claude Desktop
Clear and modular API endpoints
Support for bulk clearing of completed tasks
Easy setup with guided instructions
Context-aware resource mapping

Use Cases

Automating personal and team task workflows using Google Tasks
Integrating Google Tasks management into AI desktop assistants
Building AI-driven reminders and productivity tools
Creating custom task-list dashboards
Contextual task updates and search for enhanced productivity
Syncing tasks between applications and Google Tasks
Enabling task management features in multi-tool platforms
Facilitating quick Google Tasks access for productivity suites
Automating repetitive task organization and clean-up
Programmatic access to task details for workflow scripts

README

Google Tasks MCP Server

gtasks mcp logo smithery badge

This MCP server integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.

Components

Tools

  • search

    • Search for tasks in Google Tasks
    • Input: query (string): Search query
    • Returns matching tasks with details

  • list

    • List all tasks in Google Tasks
    • Optional input: cursor (string): Cursor for pagination
    • Returns a list of all tasks

  • create

    • Create a new task in Google Tasks
    • Input:
      • taskListId (string, optional): Task list ID
      • title (string, required): Task title
      • notes (string, optional): Task notes
      • due (string, optional): Due date
    • Returns confirmation of task creation

  • update

    • Update an existing task in Google Tasks
    • Input:
      • taskListId (string, optional): Task list ID
      • id (string, required): Task ID
      • uri (string, required): Task URI
      • title (string, optional): New task title
      • notes (string, optional): New task notes
      • status (string, optional): New task status ("needsAction" or "completed")
      • due (string, optional): New due date
    • Returns confirmation of task update

  • delete

    • Delete a task in Google Tasks
    • Input:
      • taskListId (string, required): Task list ID
      • id (string, required): Task ID
    • Returns confirmation of task deletion

  • clear

    • Clear completed tasks from a Google Tasks task list
    • Input: taskListId (string, required): Task list ID
    • Returns confirmation of cleared tasks

Resources

The server provides access to Google Tasks resources:

  • Tasks (gtasks:///<task_id>)
    • Represents individual tasks in Google Tasks
    • Supports reading task details including title, status, due date, notes, and other metadata
    • Can be listed, read, created, updated, and deleted using the provided tools

Getting started

  1. Create a new Google Cloud project
  2. Enable the Google Tasks API
  3. Configure an OAuth consent screen ("internal" is fine for testing)
  4. Add scopes https://www.googleapis.com/auth/tasks
  5. Create an OAuth Client ID for application type "Desktop App"
  6. Download the JSON file of your client's OAuth keys
  7. Rename the key file to gcp-oauth.keys.json and place into the root of this repo (i.e. gcp-oauth.keys.json)

Make sure to build the server with either npm run build or npm run watch.

Installing via Smithery

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

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

Authentication

To authenticate and save credentials:

  1. Run the server with the auth argument: npm run start auth
  2. This will open an authentication flow in your system browser
  3. Complete the authentication process
  4. Credentials will be saved in the root of this repo (i.e. .gdrive-server-credentials.json)

Usage with Desktop App

To integrate this server with the desktop app, add the following to your app's server configuration:

json
{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

Star History

Star History Chart

Repository Owner

zcaceres
zcaceres

User

Repository Details

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

Programming Languages

TypeScript
47.71%
JavaScript
47.13%
Dockerfile
5.17%

Tags

Task Management OAuth Authentication workflow-automation API server Desktop Integration

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 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 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
  • 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
  • mcp-gsuite

    mcp-gsuite

    MCP server for integrating Google Gmail and Calendar with AI tools

    mcp-gsuite enables seamless integration of Google Workspace products, such as Gmail and Calendar, with AI models via the Model Context Protocol (MCP). It supports multiple Google accounts, OAuth2 authentication, and a variety of email and calendar management functions. Users can retrieve, compose, and manage emails or calendar events, and provide rich contextual information to AI systems.

    • ⭐ 457
    • MCP
    • MarkusPfundstein/mcp-gsuite
  • 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
  • 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
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results