LogoFindMcp
Logo of gtasks-mcp

gtasks-mcp

Google Tasks MCP Server enables seamless integration with Google Tasks for listing, reading, creating, updating, and deleting tasks.

Introduction

Google Tasks MCP Server

gtasks mcp logo

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 using a query.
  • list: List all tasks in Google Tasks with pagination support.
  • create: Create a new task with title, notes, and due date.
  • update: Update an existing task, modifying title, notes, status, and due date.
  • delete: Delete a task.
  • clear: Clear completed tasks from a task list.
Resources

The server provides access to Google Tasks resources:

  • Tasks (gtasks:///<task_id>): Represents individual tasks, supporting read, create, update, and delete operations.
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:

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:

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

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates