Skip to content
Back to search

gtasks-mcp

A Google Tasks Model Context Protocol Server for Claude

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zcaceres--gtasks-mcp/badge.svg)](/listings/zcaceres--gtasks-mcp)

HTML

<a href="/listings/zcaceres--gtasks-mcp"><img src="/api/listings/zcaceres--gtasks-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. [Create a new Google Cloud project](https://console.cloud.google.com/projectcreate) 2. [Enable the Google Tasks API](https://console.cloud.google.com/workspace-api/products) 3. [Configure an OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) ("internal" is fine for testing) 4. Add scopes `https://www.googleapis.com/auth/tasks` 5. [Create an OAuth Client ID](https://console.cloud.google.com/apis/credentials/oauthclient) 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](https://smithery.ai/server/@zcaceres/gtasks):

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 108 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Google Tasks MCP Server
  2. ![gtasks mcp logo](./logo.jpg)
  3. [![smithery badge](https://smithery.ai/badge/@zcaceres/gtasks)](https://smithery.ai/server/@zcaceres/gtasks)
  4. This MCP server integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.
  5. ## Components
  6. ### Tools
  7. - **search**
  8. - Search for tasks in Google Tasks
  9. - Input: `query` (string): Search query
  10. - Returns matching tasks with details
  11. - **list**
  12. - List all tasks in Google Tasks
  13. - Optional input: `cursor` (string): Cursor for pagination
  14. - Returns a list of all tasks
  15. - **create**
  16. - Create a new task in Google Tasks
  17. - Input:
  18. - `taskListId` (string, optional): Task list ID
  19. - `title` (string, required): Task title
  20. - `notes` (string, optional): Task notes
  21. - `due` (string, optional): Due date
  22. - Returns confirmation of task creation
  23. - **update**
  24. - Update an existing task in Google Tasks
  25. - Input:
  26. - `taskListId` (string, optional): Task list ID
  27. - `id` (string, required): Task ID
  28. - `uri` (string, required): Task URI
  29. - `title` (string, optional): New task title
  30. - `notes` (string, optional): New task notes
  31. - `status` (string, optional): New task status ("needsAction" or "completed")
  32. - `due` (string, optional): New due date
  33. - Returns confirmation of task update
  34. - **delete**
  35. - Delete a task in Google Tasks
  36. - Input:
  37. - `taskListId` (string, required): Task list ID
  38. - `id` (string, required): Task ID
  39. - Returns confirmation of task deletion
  40. - **clear**
  41. - Clear completed tasks from a Google Tasks task list
  42. - Input: `taskListId` (string, required): Task list ID
  43. - Returns confirmation of cleared tasks
  44. ### Resources
  45. The server provides access to Google Tasks resources:
  46. - **Tasks** (`gtasks:///<task_id>`)
  47. - Represents individual tasks in Google Tasks
  48. - Supports reading task details including title, status, due date, notes, and other metadata
  49. - Can be listed, read, created, updated, and deleted using the provided tools
  50. ## Getting started
  51. 1. [Create a new Google Cloud project](https://console.cloud.google.com/projectcreate)
  52. 2. [Enable the Google Tasks API](https://console.cloud.google.com/workspace-api/products)
  53. 3. [Configure an OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) ("internal" is fine for testing)
  54. 4. Add scopes `https://www.googleapis.com/auth/tasks`
  55. 5. [Create an OAuth Client ID](https://console.cloud.google.com/apis/credentials/oauthclient) for application type "Desktop App"
  56. 6. Download the JSON file of your client's OAuth keys
  57. 7. Rename the key file to `gcp-oauth.keys.json` and place into the root of this repo (i.e. `gcp-oauth.keys.json`)
  58. Make sure to build the server with either `npm run build` or `npm run watch`.
  59. ### Installing via Smithery
  60. To install Google Tasks Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@zcaceres/gtasks):
  61. ```bash
  62. npx -y @smithery/cli install @zcaceres/gtasks --client claude
  63. ```
  64. ### Authentication
  65. To authenticate and save credentials:
  66. 1. Run the server with the `auth` argument: `npm run start auth`
  67. 2. This will open an authentication flow in your system browser
  68. 3. Complete the authentication process
  69. 4. Credentials will be saved in the root of this repo (i.e. `.gdrive-server-credentials.json`)
  70. ### Usage with Desktop App
  71. To integrate this server with the desktop app, add the following to your app's server configuration:
  72. ```json
  73. {
  74. "mcpServers": {
  75. "gtasks": {
  76. "command": "/opt/homebrew/bin/node",
  77. "args": [
  78. "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
  79. ]
  80. }
  81. }
  82. }
  83. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.