Gtasks MCP

🚀 Google Tasks MCP Server

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

✨ Features

Tools

• search

  • Search for tasks in Google Tasks.
  • Input: query (string): Search query.
  • Returns matching tasks and their detailed information.

• list

  • List all tasks in Google Tasks.
  • Optional input: cursor (string): Pagination cursor.
  • 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 from 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 a single task 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.

🚀 Quick Start

1. Create a new Google Cloud project.
2. Enable the Google Tasks API.
3. Configure the OAuth consent screen (set to "Internal" for testing).
4. Add the scope https://www.googleapis.com/auth/tasks.
5. Create an OAuth client ID of type Desktop app.
6. Download the client's OAuth key JSON file.
7. Rename the key file to gcp-oauth.keys.json and place it in the root directory of this repository (i.e., gcp-oauth.keys.json).

Ensure to build the project using npm run build or npm run watch.

Installation via Smithery

To automatically install the Google Tasks Server via Smithery:

npx -y @smithery/cli install @zcaceres/gtasks --desktop

Usage Instructions

• Name the server binary gtasks-mcp and place it in the default executable path.
• Run gtasks-mcp from the command line.
• Access http://localhost:8080 to use the web interface.

💻 Usage Examples

Basic Usage

# Create a task
curl -X POST http://localhost:8080/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"Complete the project","notes":"Need to finish by Friday"}'

# List all tasks
curl http://localhost:8080/api/tasks

# Update a task status
curl -X PUT http://localhost:8080/api/tasks/123 \
  -H "Content-Type: application/json" \
  -d '{"status":"completed"}'

📦 Dependencies

• Node.js and npm are installed.

Recommended Command-line Tools

• jq : For handling JSON data.
• curl : For sending HTTP requests.

📚 Additional Notes

⚠️ Important Note

Ensure that billing is enabled for your Google Cloud project.

💡 Usage Tip

Use npm install to install dependencies. Read the full documentation and examples before use.