{"id":26570815,"url":"https://github.com/arpitbatra123/mcp-googletasks","last_synced_at":"2025-05-13T17:58:44.608Z","repository":{"id":283895482,"uuid":"950784763","full_name":"arpitbatra123/mcp-googletasks","owner":"arpitbatra123","description":"This Model Context Protocol (MCP) server provides a bridge between Claude and Google Tasks, allowing you to manage your task lists and tasks directly through Claude.","archived":false,"fork":false,"pushed_at":"2025-04-23T09:00:27.000Z","size":1573,"stargazers_count":6,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-07T00:12:07.859Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/arpitbatra123.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-03-18T17:22:05.000Z","updated_at":"2025-05-02T19:39:17.000Z","dependencies_parsed_at":"2025-03-22T22:19:50.795Z","dependency_job_id":null,"html_url":"https://github.com/arpitbatra123/mcp-googletasks","commit_stats":null,"previous_names":["arpitbatra123/mcp-googletasks"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpitbatra123%2Fmcp-googletasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpitbatra123%2Fmcp-googletasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpitbatra123%2Fmcp-googletasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arpitbatra123%2Fmcp-googletasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arpitbatra123","download_url":"https://codeload.github.com/arpitbatra123/mcp-googletasks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253999866,"owners_count":21997345,"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-03-22T22:19:15.786Z","updated_at":"2025-05-13T17:58:44.593Z","avatar_url":"https://github.com/arpitbatra123.png","language":"TypeScript","funding_links":[],"categories":["Productivity","Project Management Mcp Servers","Table of Contents","📚 Projects (1974 total)","MCP 服务器精选列表","Legend","پیاده‌سازی‌های سرور","MCP Servers","Task and Project Management","🌐 Web Development","Uncategorized","Server Implementations"],"sub_categories":["Tasks \u0026 Calendar","Workflow Automation","MCP Servers","💬 通讯与协作 (Slack, Email, Calendar, Social, etc.)","💬 \u003ca name=\"communication\"\u003e\u003c/a\u003eCommunication","💬 \u003ca name=\"communication\"\u003e\u003c/a\u003eارتباطات","💬 Communication","Uncategorized"],"readme":"# Google Tasks MCP Server\n\nThis Model Context Protocol (MCP) server provides a bridge between Claude and Google Tasks, allowing you to manage your task lists and tasks directly through Claude.\n\n**Note:** All ( bar some edits ) code in this project was [\"vibe coded\"](https://en.wikipedia.org/wiki/Vibe_coding) - generated with Claude with instructions from me.\n\n## Features\n\nThis MCP server provides the following functionality:\n\n### Task List Management\n- `list-tasklists` - List all your task lists\n- `get-tasklist` - Get details about a specific task list\n- `create-tasklist` - Create a new task list\n- `update-tasklist` - Update an existing task list\n- `delete-tasklist` - Delete a task list\n\n### Task Management\n- `list-tasks` - List all tasks in a task list\n- `get-task` - Get details about a specific task\n- `create-task` - Create a new task\n- `update-task` - Update an existing task\n- `delete-task` - Delete a task\n- `complete-task` - Mark a task as completed\n- `move-task` - Move a task (reorder or change parent)\n- `clear-completed-tasks` - Clear all completed tasks from a list\n\n## Setup Instructions\n\n### 1. Create Google Cloud Project \u0026 Enable API\n\n1. Go to the [Google Cloud Console](https://console.cloud.google.com/)\n2. Create a new project\n3. Navigate to \"APIs \u0026 Services\" \u003e \"Library\"\n4. Search for \"Google Tasks API\" and enable it\n5. Go to \"APIs \u0026 Services\" \u003e \"Credentials\"\n6. Click \"Create Credentials\" \u003e \"OAuth Client ID\"\n7. Configure the OAuth consent screen (External is fine for personal use)\n8. For Application Type, select \"Web application\"\n9. Add \"http://localhost:3000\" as an authorized redirect URI\n10. Create the client ID and secret\n\n### 2. Configure Claude for Desktop\n\n1. Install [Claude for Desktop](https://claude.ai/download)\n2. Open the Claude configuration file:\n   - MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n3. Add the Google Tasks MCP server configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"google-tasks\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/google-tasks-mcp/build/index.js\"],\n      \"env\": {\n        \"GOOGLE_CLIENT_ID\": \"your_client_id_here\",\n        \"GOOGLE_CLIENT_SECRET\": \"your_client_secret_here\",\n        \"GOOGLE_REDIRECT_URI\": \"http://localhost:3000/oauth2callback\"\n      }\n    }\n  }\n}\n```\n\nReplace the path and credentials with your own values.\n\n### 3. Build and Run the Server\n\n1. Install dependencies:\n```bash\nnpm install\n```\n\n2. Build the server:\n```bash\nnpm run build\n```\n\n3. Restart Claude for Desktop\n\n## Authentication Flow\n\nWhen you first use the Google Tasks MCP server:\n\n1. Use the `authenticate` tool to get an authorization URL\n2. Visit the URL in your browser and sign in with your Google account\n3. After authorizing, you'll receive a code on the browser page\n4. Use the `set-auth-code` tool with this code to complete authentication\n5. You can now use all other tools to interact with Google Tasks\n\nNote that your authentication is session-based and will be lost when you restart the server. You'll need to re-authenticate each time.\n\n## Requirements\n\n- Node.js 14+\n- Claude for Desktop (latest version)\n- Google Cloud Project with Tasks API enabled\n\n## Screenshot\n![](./screenshot.png)\n\n## License\n\nThis project is for demonstration purposes only. Use at your own risk.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpitbatra123%2Fmcp-googletasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farpitbatra123%2Fmcp-googletasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farpitbatra123%2Fmcp-googletasks/lists"}