Google Tasks MCP Server

What is Google Tasks MCP Server about?

Integrates Google Tasks with Claude (or any MCP‑compatible client) so that tasks can be queried, created, modified, and removed programmatically.

How to use Google Tasks MCP Server?

1. Create a Google Cloud project and enable the Google Tasks API.
2. Set up OAuth consent and generate a Desktop‑App client ID.
3. Place the downloaded gcp-oauth.keys.json file in the repository root.
4. Build the server (npm run build or npm run watch).
5. Authenticate once with npm run start auth – a browser window will open for OAuth flow and credentials are saved as .gdrive-server-credentials.json.
6. Add the server to a Claude Desktop configuration (or install automatically via Smithery).

Key features of Google Tasks MCP Server

• search – query tasks with a free‑text string.
• list – paginate through all tasks in a list.
• create – add new tasks with title, notes, due date, and optional list ID.
• update – modify title, notes, status, due date, etc., for an existing task.
• delete – remove a task permanently.
• clear – bulk‑clear completed tasks from a list.
• Exposes each task as a resource (gtasks:///<task_id>) readable by MCP clients.

Use cases of Google Tasks MCP Server

• Automating personal to‑do lists from Claude prompts.
• Syncing tasks created by AI assistants with the user's Google Tasks account.
• Building workflow bots that schedule, complete, or archive tasks based on external events.
• Generating daily or weekly summaries of pending tasks for productivity dashboards.

FAQ from the Google Tasks MCP Server

Q: Do I need a paid Google Cloud account? A: No, the free tier is sufficient for the Tasks API.

Q: Where are the OAuth credentials stored? A: After running npm run start auth, they are saved in .gdrive-server-credentials.json at the repository root.

Q: Can I use this server with other AI models besides Claude? A: Yes, any client that follows the MCP specification can interact with the provided tools.

Q: How do I install the server via Smithery? A: Run npx -y @smithery/cli install @zcaceres/gtasks --client claude.

Q: What environment variables are required? A: None for basic operation; the OAuth key file supplies authentication.

Google Tasks MCP Server

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
  • Input: query (string): Search query
  • Returns matching tasks with details

• list

  • List all tasks in Google Tasks
  • Optional input: cursor (string): Cursor for pagination
  • 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 in 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 individual tasks 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

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"
      ]
    }
  }
}