Enables integration with Google Tasks API to list task lists and create new tasks with title, notes, due dates, and list assignment. Uses OAuth 2.0 authentication with automatic token refresh.
Click on "Install 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 Tasks MCP Serveradd 'buy groceries' to my shopping list"
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.
Google Tasks MCP Server
MCP server for Google Tasks API integration. Allows MCP clients (like ChatGPT) to manage your Google Tasks.
Quick Start
1. Install dependencies
bun install2. Get Google OAuth credentials
Go to Google Cloud Console
Create or select a project
Enable Google Tasks API (APIs & Services → Library)
Create OAuth credentials (APIs & Services → Credentials → Create → OAuth client ID)
Type: Web application
Redirect URI:
https://YOUR_SERVER/callback
Copy Client ID and Client Secret
3. Configure environment
Create .env file:
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-your-secret
OAUTH_SERVER_URL=https://your-server.example.com
PORT=3000 # optional, default: 30004. Run
bun run server:httpDocker
Build and run with Docker Compose:
# Start
bun run docker:up
# Stop
bun run docker:downThe container exposes port 20187 → internal 3000.
MCP Tools
Tool | Description |
| List all task lists |
| List tasks from a list |
| Create a new task |
| Update a task |
| Delete a task |
Development
bun run lint # ESLint
bun run lint:fix # ESLint with auto-fix
bun run format # Prettier
bun run typecheck # TypeScript checkArchitecture
See ARCHITECTURE.md for technical details.
License
MIT