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 install
2. 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: 3000
4. Run
bun run server:http
Docker
Build and run with Docker Compose:
# Start
bun run docker:up
# Stop
bun run docker:down
The container exposes port 20187 → internal 3000.
MCP Tools
| Tool | Description |
|---|---|
tasklists_list | List all task lists |
tasks_list | List tasks from a list |
task_create | Create a new task |
task_update | Update a task |
task_delete | Delete a task |
Development
bun run lint # ESLint
bun run lint:fix # ESLint with auto-fix
bun run format # Prettier
bun run typecheck # TypeScript check
Architecture
See ARCHITECTURE.md for technical details.
License
MIT