Google Tasks MCP Server

# 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 ```bash bun install ``` ### 2. Get Google OAuth credentials 1. Go to [Google Cloud Console](https://console.cloud.google.com/) 2. Create or select a project 3. Enable **Google Tasks API** (APIs & Services → Library) 4. Create OAuth credentials (APIs & Services → Credentials → Create → OAuth client ID) - Type: Web application - Redirect URI: `https://YOUR_SERVER/callback` 5. Copy Client ID and Client Secret ### 3. Configure environment Create `.env` file: ```bash 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 ```bash bun run server:http ``` ## Docker Build and run with Docker Compose: ```bash # 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 ```bash 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](./ARCHITECTURE.md) for technical details. ## License MIT