gtasks-mcp
Author: zcaceres
Description: 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.
Stars: 70
Forks: 21
License: MIT License
Category: Open Source
Overview
Installation
1. Clone the repository
git clone https://github.com/zcaceres/gtasks-mcp.git && cd gtasks-mcp2. Install dependencies
npm install # or: pnpm install / yarn install3. 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.js6. (Optional) Docker
docker build -t gtasks-mcp .
docker run -d --env-file .env -p 3000:3000 gtasks-mcpAfter the service starts it will listen on `http://localhost:3000` and expose MCP-compliant routes.
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
License: MIT License
Updated 7/30/2025