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