google-task-mcp
This server lets MCP clients (like Codex or ChatGPT desktop) manage Google Tasks locally over STDIO, with OAuth stored on your machine.
Connect a Google account via local OAuth (get authorization URL, then complete authorization)
List Google Task lists
List tasks in a list, with optional filtering for completed/hidden tasks and a max result limit
Create tasks (including subtasks via parent) with title, notes, and RFC 3339 due dates
Update a task's title, notes, or due date
Mark tasks complete or reopen them
Delete tasks, but only after explicit user confirmation (
confirm: true)
Provides tools for listing, creating, updating, completing, uncompleting, and deleting tasks in Google Tasks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-task-mcp show my task lists"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TaskBridge
TaskBridge lets you use Google Tasks from Codex or any MCP client that can run a local STDIO server. It can list task lists and tasks, create or edit tasks, mark tasks complete, and delete tasks after explicit confirmation.
Everything runs locally. The server talks directly to the Google Tasks API and stores the OAuth token on your computer.
What you need
Node.js 20 or newer
A Google account with Google Tasks enabled
A Google Cloud project
Codex, the ChatGPT desktop app, or another MCP client with local STDIO support
Related MCP server: Google Tasks MCP Server
Set up the project
1. Download and install
git clone https://github.com/zakikero/google-task-mcp.git
cd google-task-mcp
npm installRun the checks to confirm that your local copy is ready:
npm run verify2. Create Google OAuth credentials
Open the Google Cloud Console and create or select a project.
Enable the Google Tasks API.
Open Google Auth platform → Branding and configure the consent screen.
Under Audience, use Internal for a Google Workspace organization or External for a personal Google account. If the app is in testing, add the Google account you will use as a test user.
Open Google Auth platform → Clients, select Create client, and choose Desktop app.
Copy the generated client ID and client secret.
Google supports loopback addresses for desktop OAuth clients, so the included local callback URL works without hosting a web server. See Google's Tasks API Node.js quickstart and desktop OAuth guidance for more detail.
3. Add your credentials
Create a local .env file from the example:
Copy-Item .env.example .envOn macOS or Linux, use cp .env.example .env instead. Then replace the placeholder values:
GOOGLE_TASKS_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_TASKS_CLIENT_SECRET=your-client-secret
GOOGLE_TASKS_REDIRECT_URI=http://127.0.0.1:53682/oauth2callbackThe server loads this .env file from the repository directory even when it is launched from somewhere else. .env is ignored by Git.
4. Connect Codex
The simplest development setup is to add this repository as a local MCP server. Replace the example path with the absolute path to your clone:
codex mcp add google-task-mcp -- node C:\path\to\google-task-mcp\server\index.jsYou can also add it in the ChatGPT desktop app under Settings → MCP servers → Add server:
Name:
google-task-mcpType:
STDIOCommand:
nodeArguments: the absolute path to
server/index.js
Save the server and restart the app. Codex's MCP configuration is shared with the desktop app and IDE extension; the current options are documented in the official MCP setup guide.
This repository also contains .codex-plugin/plugin.json and .mcp.json for packaging it as a Codex plugin.
The plugin configuration pre-approves only google_tasks_list_tasklists and
google_tasks_list_tasks. This lets unattended scheduled tasks read Google Tasks while create,
update, completion, authorization, and deletion operations continue to require approval.
5. Authorize Google Tasks
Start a new chat and ask:
Connect my Google Tasks account.
The client should call google_tasks_get_authorization_url. Open the returned URL, approve access, return to the chat, and ask it to finish authorization. The authorization attempt expires after 10 minutes.
Try one of these prompts afterward:
“Show my open Google Tasks.”
“Create a task called Pay electricity bill due tomorrow.”
“Mark my grocery task complete.”
Available tools
Tool | Purpose |
| Start local Google OAuth authorization |
| Finish authorization after browser consent |
| List task lists |
| List tasks, optionally including completed or hidden tasks |
| Create a task or subtask |
| Change a task's title, notes, or due date |
| Complete or reopen a task |
| Permanently delete a task after explicit confirmation |
Task list IDs default to @default. Due dates use RFC 3339 timestamps, such as 2026-08-18T17:00:00Z; Google Tasks stores the date and may discard the time portion.
Local data and safety
The OAuth token is stored at
%APPDATA%\google-task-mcp\token.jsonon Windows or~/.config/google-task-mcp/token.jsonon macOS and Linux.Set
GOOGLE_TASKS_TOKEN_PATHin.envto use a different location.Delete the token file to disconnect the Google account. You can also revoke access from your Google Account settings.
The server requests only
https://www.googleapis.com/auth/tasks.Task deletion requires
confirm: true; clients should show the exact task and ask before calling it..env, token directories, logs, and dependencies are excluded from Git. Never commit credentials or tokens.
Troubleshooting
The MCP server exits immediately
Check that .env exists beside package.json and contains both GOOGLE_TASKS_CLIENT_ID and GOOGLE_TASKS_CLIENT_SECRET.
Google reports redirect_uri_mismatch
Confirm that you created a Desktop app OAuth client and kept GOOGLE_TASKS_REDIRECT_URI set to the included loopback URL.
The authorization URL expires
Run google_tasks_get_authorization_url again. Only one authorization attempt can be active at a time.
Port 53682 is already in use
Choose an unused local port in .env, restart the MCP server, and begin authorization again.
A scheduled task says connector approval is unavailable
Install the repository as the Codex plugin rather than registering only the MCP server. The
included .mcp.json safely pre-approves the two read-only tools needed by scheduled tasks. Restart
Codex after installing an updated plugin, then test the scheduled prompt once in a regular chat.
Do not pre-approve the whole server because it also contains tools that modify and delete tasks.
Development
The server is split by responsibility:
server/
config.js Environment and path configuration
google-auth.js OAuth callback and Google API client
index.js Server startup
mcp-result.js MCP text response formatting
tools.js Tool schemas and handlers
test/ Node.js unit testsUseful commands:
npm run check # Syntax-check server files
npm test # Run unit tests
npm run verify # Run both checks
npm start # Start the STDIO server manuallyOAuth and live Google API calls require real credentials and interactive browser consent. Unit tests do not contact Google.
License
Released under the MIT License.
Available Tools
8 toolsgoogle_tasks_complete_authorizationA
Confirm the browser OAuth callback has completed and save the local token.
Inputs: no named parameters.
google_tasks_create_taskC
Create a Google Task. Due dates are RFC 3339 timestamps, for example 2026-08-18T17:00:00Z.
Inputs: title (required), due, notes, parent, +2 more.
google_tasks_delete_taskA
Permanently delete one task. First show the exact task to the user; this tool refuses to run without confirm: true.
Inputs: taskId (required), confirm (required), tasklistId.
google_tasks_get_authorization_urlA
Start local OAuth 2.0 authorization and return the URL the user must open in a browser.
Inputs: no named parameters.
google_tasks_list_tasklistsB
List the user's Google Tasks lists.
Inputs: no named parameters.
google_tasks_list_tasksC
List tasks in a Google Task list.
Inputs: maxResults, showHidden, tasklistId, showCompleted.
google_tasks_set_task_completionC
Complete or uncomplete a task.
Inputs: taskId (required), completed (required), tasklistId.
google_tasks_update_taskB
Update a task's title, notes, or due date. At least one editable field is required.
Inputs: taskId (required), due, notes, title, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool addresses a distinct operation: authorization, listing, creation, update, completion, and deletion. There is no overlap or ambiguity between the tools.
All tools follow a consistent `google_tasks_<verb>_<noun>` pattern, with clear, predictable verbs like `list`, `create`, `update`, and `delete`.
With 8 tools, the set covers the core lifecycle of managing Google Tasks (auth, lists, tasks) without being excessive or sparse. Each tool has a clear purpose.
The tool set provides full CRUD for tasks (create, read, update, delete) plus completion toggling and authorization. It lacks a `get_task` detail endpoint, but the list tool likely returns sufficient information for most workflows.
Maintenance
Related MCP Connectors
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Read and edit your Tasks boards: create and update tasks, comment, and track time.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceIntegrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.176MIT
- FlicenseNot gradedqualityDmaintenanceEnables integration with Google Tasks API to create and manage tasks through OAuth 2.0 authentication. Supports listing task lists and creating new tasks with automatic token refresh.-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage Google Tasks through natural language interactions. Supports creating, updating, deleting, searching, and listing tasks with secure OAuth2 authentication.132 npm10MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.MIT