Google Tasks MCP Server

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