MCP Google Tasks

🚀 Google Tasks MCP Server

A TypeScript-based MCP server for managing Google Tasks. This server demonstrates core MCP concepts and enables interactive management of tasks by integrating with the Google Tasks API, offering task management features in a structured and efficient manner.

🚀 Quick Start

To start the server:

node build/index.js

✨ Features

Resources

• Default Task List: Access the default Google Tasks list via the URI tasks://default.
• Task Details: Provide metadata about tasks, such as title, notes, and completion status.
• JSON MIME Type: Tasks are represented in machine-readable JSON format.

Tools

• create_task: Create a new task in the default task list.

  • Parameters:
    • title (string, optional): The title of the task.
    • notes (string, optional): Additional notes for the task.
    • taskId (string, optional): The unique ID of the task.
    • status (string, optional): The status of the task (e.g., "needsAction" or "completed").
  • Response: Returns detailed information about the created task.

• list_tasks: List all tasks in the default task list.

  • Parameters: None.
  • Response: Returns a JSON array of all tasks in the default task list.

• delete_task: Delete a task from the default task list.

  • Parameters:
    • taskId (string, required): The ID of the task to be deleted.
  • Response: Confirms the successful deletion of the task.

• update_task: Update the details of an existing task.

  • Parameters:
    • taskId (string, required): The ID of the task to be updated.
    • title (string, optional): The new title of the task.
    • notes (string, optional): The new notes for the task.
  • Response: Returns the updated details of the task.

• complete_task: Toggle the completion status of a task.

  • Parameters:
    • taskId (string, required): The ID of the task to toggle the completion status.
  • Response: Returns the updated details of the task, including the new status.

📚 Documentation

• It provides easy integration with large language models (LLMs) or other applications.
• The structured tool definitions make task management intuitive and accessible.
• It fully supports functions such as creating, listing, deleting, updating, and toggling the completion status of tasks.

💻 Usage Examples

Basic Usage

create_task

Create a new task with optional parameters.

{
    "title": "Complete the project",
    "notes": "Finish Module 3",
    "status": "needsAction"
}

list_tasks

Retrieve all tasks in the default task list.

// No parameters required

delete_task

Delete a task based on the task ID.

{
    "taskId": "Unique task ID"
}

update_task

Update the title, notes, or other details of an existing task.

{
    "taskId": "Unique task ID",
    "title": "New title",
    "notes": "New notes"
}

complete_task

Toggle the completion status of a task.

{
    "taskId": "Unique task ID"
}

🔧 Technical Details

When debugging, you can use the MCP Inspector tool to analyze and solve problems. For more information, visit MCP Inspector.

📄 License

This software is licensed under the MIT License. See the LICENSE file for details.