Integrations
Allows listing, reading, searching, creating, updating, and deleting tasks in Google Tasks. Supports accessing task details including title, status, due date, notes, and other metadata.
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 IDtitle
(string, required): Task titlenotes
(string, optional): Task notesdue
(string, optional): Due date
- Returns confirmation of task creation
- update
- Update an existing task in Google Tasks
- Input:
taskListId
(string, optional): Task list IDid
(string, required): Task IDuri
(string, required): Task URItitle
(string, optional): New task titlenotes
(string, optional): New task notesstatus
(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 IDid
(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
- Create a new Google Cloud project
- Enable the Google Tasks API
- Configure an OAuth consent screen ("internal" is fine for testing)
- Add scopes
https://www.googleapis.com/auth/tasks
- Create an OAuth Client ID for application type "Desktop App"
- Download the JSON file of your client's OAuth keys
- 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:
Authentication
To authenticate and save credentials:
- Run the server with the
auth
argument:npm run start auth
- This will open an authentication flow in your system browser
- Complete the authentication process
- 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:
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.
Related Resources
Related MCP Servers
- -securityAlicense-qualityEnables integration with Google Drive for listing, reading, and searching over files, supporting various file types with automatic export for Google Workspace files.Last updated -1,4959JavaScriptMIT License
- -securityAlicense-qualityIntegrates with Google Drive to enable listing, searching, and reading files, plus reading and writing to Google Sheets.Last updated -9186TypeScriptMIT License
- AsecurityFlicenseAqualityA TypeScript Model Context Protocol server that integrates with Google Tasks API, allowing users to create, list, update, delete, and toggle completion status of tasks.Last updated -43JavaScript
- -security-license-qualityIntegrates with Google Drive to enable listing, reading, and searching over files, with automatic export of Google Workspace documents to appropriate formats.Last updated -1,495JavaScript