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.
Badge for your README
Markdown
[](/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
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)
- # Google Tasks MCP Server
- 
- [](https://smithery.ai/server/@zcaceres/gtasks)
- 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](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):
- ```bash
- 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:
- ```json
- {
- "mcpServers": {
- "gtasks": {
- "command": "/opt/homebrew/bin/node",
- "args": [
- "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
- ]
- }
- }
- }
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.