mcp-registry/gtasks-mcp

    ==================
      
       /// MCP ///
      /// GTA ///
        
    ==================
        
    [server:online]
    [protocol:ready]

gtasks-mcp

by zcaceres

A Model-Context-Protocol (MCP) server that exposes Google Tasks as list/search/create/update/delete/clear tools for Claude or any MCP-compatible client.

70
21
Open Source
GitHubNPM

01

search

Search for tasks in Google Tasks using a query string

02

list

List all tasks in Google Tasks, with optional pagination via cursor

03

create

Create a new task in Google Tasks with optional task list, notes, and due date

04

update

Update an existing Google Task’s details such as title, notes, status or due date

05

delete

Delete a specific task from a Google Tasks list

06

clear

Clear all completed tasks from a specified Google Tasks task list

Installation

1. Clone the repository
git clone https://github.com/zcaceres/gtasks-mcp.git && cd gtasks-mcp
2. Install dependencies
npm install # or: pnpm install / yarn install
3. Configure environment variables
- Copy the example file if it exists, or create a new `.env` file:
cp .env.example .env
- Fill in the required Google credentials:
GOOGLE_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx GOOGLE_REFRESH_TOKEN=1//04xxxxxxxxxxxxxxxxxxxxxxxx PORT=3000 # (optional) default 3000
- Enable the **Google Tasks API** in your Google Cloud project and create an OAuth 2.0 Client (Desktop or Web) to obtain the above credentials.
4. Build the TypeScript source (optional in dev; required in prod)
npm run build # outputs to dist/
5. Run the server
# Development (with nodemon + ts-node) npm run dev # Production npm start # or: node dist/index.js
6. (Optional) Docker
docker build -t gtasks-mcp . docker run -d --env-file .env -p 3000:3000 gtasks-mcp
After the service starts it will listen on `http://localhost:3000` and expose MCP-compliant routes.

Documentation

License: MIT License
Updated 7/30/2025