Google Tasks MCP Server

@ktmage

About Google Tasks MCP Server

AI assistants and Google Tasks integration through Model Context Protocol.

#todo #mcp #mcp-server #modelcontextprotocol

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-google-tasks-ktmage": {
      "command": "node",
      "args": [
        "build/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Tasks MCP Server?

An implementation for interacting with Google Tasks API through the Model Context Protocol (MCP). It enables MCP-compatible clients—such as Cursor—to use Google Tasks task management features directly from an AI assistant.

How to use Google Tasks MCP Server?

Clone the repository, install dependencies with npm install, enable the Google Tasks API in Google Cloud Console, and place a downloaded OAuth 2.0 desktop app credential file as credentials.json in the project root. Build with npm run build and run with node build/index.js; on first launch, a browser window prompts Google account authentication and generates a token.json for subsequent runs. For Cursor, add the server to ~/.cursor/mcp.json with "command": "node" and the full path to build/index.js.

Key features of Google Tasks MCP Server

Fetch all task list collections
List tasks within a specific task list
Create new tasks with optional notes and due date
Mark tasks as completed
Delete tasks

Use cases of Google Tasks MCP Server

Managing Google Tasks from an AI assistant in a Cursor IDE session
Automating task creation and completion based on AI-generated workflows
Querying task lists and individual tasks without leaving the development environment

FAQ from Google Tasks MCP Server

What dependencies and runtime are required?

Node.js 16 or higher and npm are required, along with a Google Cloud Project account with the Google Tasks API enabled.

How does authentication work?

OAuth 2.0 is used. A downloaded credentials JSON file (renamed to credentials.json) must be placed in the project root. On first run, a browser window asks for Google account authentication, which creates a token.json file used automatically thereafter.

Where are credentials and tokens stored?

The OAuth client file is stored as credentials.json in the project root. The authentication token is stored locally as token.json in the same directory.

What transports and authentication methods are supported?

The README specifies standard MCP stdio transport (via the mcp.json configuration) and OAuth 2.0 for Google Tasks API access. No other transports are mentioned.

What should I do if I get an "invalid_grant" error?

Delete the token.json file and re-authenticate. Also verify that the Google Tasks API is enabled for the project in the Google Cloud Console.

Frequently asked questions

What dependencies and runtime are required?

Node.js 16 or higher and npm are required, along with a Google Cloud Project account with the Google Tasks API enabled.

How does authentication work?

OAuth 2.0 is used. A downloaded credentials JSON file (renamed to `credentials.json`) must be placed in the project root. On first run, a browser window asks for Google account authentication, which creates a `token.json` file used automatically thereafter.

Where are credentials and tokens stored?

The OAuth client file is stored as `credentials.json` in the project root. The authentication token is stored locally as `token.json` in the same directory.

What transports and authentication methods are supported?

The README specifies standard MCP stdio transport (via the `mcp.json` configuration) and OAuth 2.0 for Google Tasks API access. No other transports are mentioned.

What should I do if I get an "invalid_grant" error?

Delete the `token.json` file and re-authenticate. Also verify that the Google Tasks API is enabled for the project in the Google Cloud Console.

Comments

Basic information

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.