{"id":24161560,"url":"https://github.com/zcaceres/gtasks-mcp","last_synced_at":"2025-06-28T01:05:35.547Z","repository":{"id":268619762,"uuid":"904953715","full_name":"zcaceres/gtasks-mcp","owner":"zcaceres","description":"A Google Tasks Model Context Protocol Server for Claude","archived":false,"fork":false,"pushed_at":"2025-02-02T19:25:00.000Z","size":1125,"stargazers_count":31,"open_issues_count":4,"forks_count":10,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-04T19:54:20.400Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zcaceres.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-17T21:44:26.000Z","updated_at":"2025-04-02T02:36:39.000Z","dependencies_parsed_at":"2025-02-02T20:31:16.088Z","dependency_job_id":null,"html_url":"https://github.com/zcaceres/gtasks-mcp","commit_stats":null,"previous_names":["zcaceres/gtasks-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zcaceres/gtasks-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fgtasks-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fgtasks-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fgtasks-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fgtasks-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zcaceres","download_url":"https://codeload.github.com/zcaceres/gtasks-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zcaceres%2Fgtasks-mcp/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262357553,"owners_count":23298463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-12T17:17:20.705Z","updated_at":"2025-06-28T01:05:35.526Z","avatar_url":"https://github.com/zcaceres.png","language":"TypeScript","funding_links":[],"categories":["Productivity","Project Management MCP Servers","Table of Contents","サーバー実装","📚 Projects (1974 total)","Community Servers","Other Tools and Integrations","Legend","MCP 服务器精选列表","MCP Servers","Task and Project Management","🌐 Web Development","🗂️ Extensions by Category","Uncategorized","💬 Communication (48 servers)","Server Implementations","Communication"],"sub_categories":["Tasks \u0026 Calendar","AI Services","🛠️ \u003ca name=\"developer-tools\"\u003e\u003c/a\u003e開発者ツール","MCP Servers","How to Submit","💬 \u003ca name=\"communication\"\u003e\u003c/a\u003eCommunication","💬 通讯与协作 (Slack, Email, Calendar, Social, etc.)","💬 Communication","⚡ Productivity","Uncategorized"],"readme":"# Google Tasks MCP Server\n\n![gtasks mcp logo](./logo.jpg)\n[![smithery badge](https://smithery.ai/badge/@zcaceres/gtasks)](https://smithery.ai/server/@zcaceres/gtasks)\n\nThis MCP server integrates with Google Tasks to allow listing, reading, searching, creating, updating, and deleting tasks.\n\n## Components\n\n### Tools\n\n- **search**\n  - Search for tasks in Google Tasks\n  - Input: `query` (string): Search query\n  - Returns matching tasks with details\n\n- **list**\n  - List all tasks in Google Tasks\n  - Optional input: `cursor` (string): Cursor for pagination\n  - Returns a list of all tasks\n\n- **create**\n  - Create a new task in Google Tasks\n  - Input:\n    - `taskListId` (string, optional): Task list ID\n    - `title` (string, required): Task title\n    - `notes` (string, optional): Task notes\n    - `due` (string, optional): Due date\n  - Returns confirmation of task creation\n\n- **update**\n  - Update an existing task in Google Tasks\n  - Input:\n    - `taskListId` (string, optional): Task list ID\n    - `id` (string, required): Task ID\n    - `uri` (string, required): Task URI\n    - `title` (string, optional): New task title\n    - `notes` (string, optional): New task notes\n    - `status` (string, optional): New task status (\"needsAction\" or \"completed\")\n    - `due` (string, optional): New due date\n  - Returns confirmation of task update\n\n- **delete**\n  - Delete a task in Google Tasks\n  - Input:\n    - `taskListId` (string, required): Task list ID\n    - `id` (string, required): Task ID\n  - Returns confirmation of task deletion\n\n- **clear**\n  - Clear completed tasks from a Google Tasks task list\n  - Input: `taskListId` (string, required): Task list ID\n  - Returns confirmation of cleared tasks\n\n### Resources\n\nThe server provides access to Google Tasks resources:\n\n- **Tasks** (`gtasks:///\u003ctask_id\u003e`)\n  - Represents individual tasks in Google Tasks\n  - Supports reading task details including title, status, due date, notes, and other metadata\n  - Can be listed, read, created, updated, and deleted using the provided tools\n\n## Getting started\n\n1. [Create a new Google Cloud project](https://console.cloud.google.com/projectcreate)\n2. [Enable the Google Tasks API](https://console.cloud.google.com/workspace-api/products)\n3. [Configure an OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) (\"internal\" is fine for testing)\n4. Add scopes `https://www.googleapis.com/auth/tasks`\n5. [Create an OAuth Client ID](https://console.cloud.google.com/apis/credentials/oauthclient) for application type \"Desktop App\"\n6. Download the JSON file of your client's OAuth keys\n7. Rename the key file to `gcp-oauth.keys.json` and place into the root of this repo (i.e. `gcp-oauth.keys.json`)\n\nMake sure to build the server with either `npm run build` or `npm run watch`.\n\n### Installing via Smithery\n\nTo install Google Tasks Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@zcaceres/gtasks):\n\n```bash\nnpx -y @smithery/cli install @zcaceres/gtasks --client claude\n```\n\n### Authentication\n\nTo authenticate and save credentials:\n\n1. Run the server with the `auth` argument: `npm run start auth`\n2. This will open an authentication flow in your system browser\n3. Complete the authentication process\n4. Credentials will be saved in the root of this repo (i.e. `.gdrive-server-credentials.json`)\n\n### Usage with Desktop App\n\nTo integrate this server with the desktop app, add the following to your app's server configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"gtasks\": {\n      \"command\": \"/opt/homebrew/bin/node\",\n      \"args\": [\n        \"{ABSOLUTE PATH TO FILE HERE}/dist/index.js\"\n      ]\n    }\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcaceres%2Fgtasks-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzcaceres%2Fgtasks-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzcaceres%2Fgtasks-mcp/lists"}