How to Connect Google Tasks to Gemini via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Google Tasks, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Google Tasks + Gemini

Let your AI manage Google Tasks: see your task lists and what is open or due, add tasks and subtasks with due dates, update, complete and reorder them or move them to another list. The same tasks you see in Gmail, Google Calendar and the Tasks app. Personal Google accounts and Google Workspace.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Step 1 — Get credentials

1. Open console.cloud.google.com, pick or create a project, then go to APIs & Services → Library and enable the Google Tasks API.
2. Open APIs & Services → OAuth consent screen. Choose Internal if you are on Google Workspace (the simplest option), otherwise External. For External, set the publishing status to In production: while the app is in Testing, Google revokes its refresh tokens after 7 days and the connector stops working every week. For your own account you can click through the "unverified app" warning.
3. Open APIs & Services → Credentials → Create credentials → OAuth client ID, choose the application type Web application and add the authorized redirect URI https://cloud.anythingmcp.com/api/mcp-oauth/callback. If you host AnythingMCP yourself, enter https://your-anythingmcp-host/api/mcp-oauth/callback instead.
4. Paste the client ID into GOOGLE_CLIENT_ID and the client secret into GOOGLE_CLIENT_SECRET, then install the connector.
5. On the connector page, click Authorize with Provider and sign in with the Google account whose tasks the AI should use. The refresh token is stored encrypted and access tokens are renewed automatically.

One Google client for all Google connectors: the same Cloud project and OAuth client can serve every Google connector: Gmail, Google Calendar, Google Drive, Google Sheets, Google Docs, Google Tasks, Search Console, Analytics and Ads. Enable each API in that project, reuse the same client ID and secret, and authorize each connector once. Each one asks only for its own permissions.

Good to know: these are the same tasks you see in Gmail, Google Calendar and the Google Tasks app. Google Tasks stores only the day of a due date, so a time of day cannot be set. Tasks completed in the Google apps are hidden by default, so ask for completed tasks explicitly when you need them.

Permissions: the connector asks for https://www.googleapis.com/auth/tasks: read and change your tasks and task lists.

Read-only setup: change the scope in the connector's OAuth settings to https://www.googleapis.com/auth/tasks.readonly, authorize again and disable gtasks_create_tasklist, gtasks_create_task, gtasks_update_task, gtasks_complete_task and gtasks_move_task.

Switched off at install: gtasks_delete_task. Completing a task is usually what you mean; turn deleting on only if the AI should remove tasks.

Common errors: 401 means the authorization expired or was revoked (always after 7 days while the consent screen is in Testing): click Authorize with Provider again. 403 accessNotConfigured means the Google Tasks API is not enabled in the Cloud project. 403 insufficientPermissions means the scope does not allow the call (a change on a read-only setup). 404 means the list or task id is wrong, or the task belongs to another list.

The connector does not rename or delete task lists, clear completed tasks or set up recurring tasks.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell): anythingmcp should show as connected.
4. Start prompting: Gemini CLI can now call the Google Tasks tools.

Available tools

Example prompts

• "What tasks are due this week?"
• "Add a task Send the Q3 report to My Tasks, due Friday, with subtasks for collecting the figures and writing the summary."
• "Mark the task Book flights as done."
• "Move all open tasks from the Inbox list to Project Alpha."

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT
• Connect to Cursor
• Connect to Meta Muse