Skip to content
MCP server

Google Tasks MCP

MCP server for the Google Tasks API: task lists, subtasks, due dates, complete and move…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.2
Listing updated
4 days ago

About Google Tasks MCP

Google Tasks MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

MCP server for the Google Tasks API: task lists, subtasks, due dates, complete and move tasks.

Install

Run in a terminal

claude mcp add mcp-google-tasks --env GOOGLE_TASKS_CLIENT_SECRET='<GOOGLE_TASKS_CLIENT_SECRET>' --env GOOGLE_TASKS_REFRESH_TOKEN='<GOOGLE_TASKS_REFRESH_TOKEN>' --env GOOGLE_TASKS_ACCESS_TOKEN='<GOOGLE_TASKS_ACCESS_TOKEN>' -- npx -y mcp-google-tasks

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-google-tasks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-tasks"
      ],
      "env": {
        "GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
        "GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
        "GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-google-tasks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-tasks"
      ],
      "env": {
        "GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
        "GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
        "GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-google-tasks": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-tasks"
      ],
      "env": {
        "GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
        "GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
        "GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-google-tasks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-tasks"
      ],
      "env": {
        "GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
        "GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
        "GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-google-tasks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-tasks"
      ],
      "env": {
        "GOOGLE_TASKS_CLIENT_SECRET": "<GOOGLE_TASKS_CLIENT_SECRET>",
        "GOOGLE_TASKS_REFRESH_TOKEN": "<GOOGLE_TASKS_REFRESH_TOKEN>",
        "GOOGLE_TASKS_ACCESS_TOKEN": "<GOOGLE_TASKS_ACCESS_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_TASKS_CLIENT_IDGoogle OAuth2 client id (refresh-token flow).
  • GOOGLE_TASKS_CLIENT_SECRETGoogle OAuth2 client secret (refresh-token flow). Treat it as a secret.
  • GOOGLE_TASKS_REFRESH_TOKENGoogle OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.
  • GOOGLE_TASKS_ACCESS_TOKENStatic OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.
  • GOOGLE_TASKS_OAUTH_PORTFixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.
  • GOOGLE_TASKS_API_BASEAPI root override.
  • GOOGLE_TASKS_TIMEOUT_MSPer-request timeout in milliseconds.
  • GOOGLE_TASKS_MAX_RETRIESRetries on transient errors (429 always; 5xx/network for reads).

Pricing

Open source

Google Tasks MCP FAQ

Is Google Tasks MCP free?

Yes. Google Tasks MCP is open source, so you can use and self-host it for free.

How do I add Google Tasks MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-google-tasks --env GOOGLE_TASKS_CLIENT_SECRET='<GOOGLE_TASKS_CLIENT_SECRET>' --env GOOGLE_TASKS_REFRESH_TOKEN='<GOOGLE_TASKS_REFRESH_TOKEN>' --env GOOGLE_TASKS_ACCESS_TOKEN='<GOOGLE_TASKS_ACCESS_TOKEN>' -- npx -y mcp-google-tasks

What are the best alternatives to Google Tasks MCP?

The closest alternatives to Google Tasks MCP are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Google Tasks MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media