Can I use Google Tasks as a CLI?

Yes. KosmoKrator exposes a Google Tasks CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Google Tasks through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Google Tasks tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Google Tasks credentials stored?

Google Tasks credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Google Tasks MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Google Tasks Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Google Tasks KosmoKrator integration.

Lua Namespace

Agents call this integration through app.integrations.google_tasks.*. Use lua_read_doc("integrations.google-tasks") inside KosmoKrator to discover the same reference at runtime.

Call Lua from the Headless CLI

Use kosmo integrations:lua when a shell script, CI job, cron job, or another coding CLI should run a deterministic Google Tasks workflow without starting an interactive agent session.

Inline Lua call

kosmo integrations:lua --eval 'dump(app.integrations.google_tasks.update({}))' --json

Read Lua docs headlessly

kosmo integrations:lua --eval 'print(docs.read("google-tasks"))' --json
kosmo integrations:lua --eval 'print(docs.read("google-tasks.update"))' --json

Workflow file

Put repeatable logic in a Lua file, then execute it with JSON output for the calling process.

workflow.lua

local google_tasks = app.integrations.google_tasks
local result = google_tasks.update({})

dump(result)

Run the workflow

kosmo integrations:lua workflow.lua --json
kosmo integrations:lua workflow.lua --force --json

Namespace note. integrations:lua exposes app.integrations.google_tasks, app.mcp.*, docs.*, json.*, and regex.*. Use app.integrations.google_tasks.default.* or app.integrations.google_tasks.work.* when you configured named credential accounts.

MCP-only Lua

If the script only needs configured MCP servers and does not need Google Tasks, use the narrower mcp:lua command.

MCP Lua command

# Use mcp:lua for MCP-only scripts; use integrations:lua for this integration namespace.
kosmo mcp:lua --eval 'dump(mcp.servers())' --json

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Google Tasks

Google Tasks tools are exposed under app.integrations.google_tasks. This package is generated from Google’s official Tasks API v1 Discovery document and exposes 14 REST methods.

Coverage

Source: https://www.googleapis.com/discovery/v1/apis/tasks/v1/rest
Read tools: 4
Write tools: 10
Base URL: https://tasks.googleapis.com

Usage Notes

Pass tasklist and task path parameters as top-level arguments. Query parameters can be passed as top-level shortcuts or inside query. Insert, update, and patch methods accept the official Task or TaskList object inside body.

Google Tasks dates are date-only RFC 3339 timestamps in the API; the upstream API does not preserve arbitrary time-of-day values for due dates.

Tools

google_tasks_tasks_update - PUT /tasks/v1/lists/{tasklist}/tasks/{task}
google_tasks_tasks_move - POST /tasks/v1/lists/{tasklist}/tasks/{task}/move
google_tasks_tasks_delete - DELETE /tasks/v1/lists/{tasklist}/tasks/{task}
google_tasks_tasks_clear - POST /tasks/v1/lists/{tasklist}/clear
google_tasks_tasks_get - GET /tasks/v1/lists/{tasklist}/tasks/{task}
google_tasks_tasks_insert - POST /tasks/v1/lists/{tasklist}/tasks
google_tasks_tasks_list - GET /tasks/v1/lists/{tasklist}/tasks
google_tasks_tasks_patch - PATCH /tasks/v1/lists/{tasklist}/tasks/{task}
google_tasks_tasklists_delete - DELETE /tasks/v1/users/@me/lists/{tasklist}
google_tasks_tasklists_get - GET /tasks/v1/users/@me/lists/{tasklist}
google_tasks_tasklists_insert - POST /tasks/v1/users/@me/lists
google_tasks_tasklists_list - GET /tasks/v1/users/@me/lists
google_tasks_tasklists_patch - PATCH /tasks/v1/users/@me/lists/{tasklist}
google_tasks_tasklists_update - PUT /tasks/v1/users/@me/lists/{tasklist}

Examples

local lists = app.integrations.google_tasks.google_tasks_tasklists_list({ maxResults = 10 })

local task = app.integrations.google_tasks.google_tasks_tasks_insert({
  tasklist = "MDM4NzA1...",
  body = { title = "Follow up", notes = "Send recap email" }
})

Responses are decoded Google Tasks JSON responses, or { success = true, status = ... } for successful empty responses such as deletes and clears.

Raw agent markdown

# Google Tasks

Google Tasks tools are exposed under `app.integrations.google_tasks`. This package is generated from Google's official Tasks API v1 Discovery document and exposes 14 REST methods.

## Coverage

- Source: `https://www.googleapis.com/discovery/v1/apis/tasks/v1/rest`
- Read tools: 4
- Write tools: 10
- Base URL: `https://tasks.googleapis.com`

## Usage Notes

Pass `tasklist` and `task` path parameters as top-level arguments. Query parameters can be passed as top-level shortcuts or inside `query`. Insert, update, and patch methods accept the official Task or TaskList object inside `body`.

Google Tasks dates are date-only RFC 3339 timestamps in the API; the upstream API does not preserve arbitrary time-of-day values for due dates.

## Tools

- `google_tasks_tasks_update` - PUT /tasks/v1/lists/{tasklist}/tasks/{task}
- `google_tasks_tasks_move` - POST /tasks/v1/lists/{tasklist}/tasks/{task}/move
- `google_tasks_tasks_delete` - DELETE /tasks/v1/lists/{tasklist}/tasks/{task}
- `google_tasks_tasks_clear` - POST /tasks/v1/lists/{tasklist}/clear
- `google_tasks_tasks_get` - GET /tasks/v1/lists/{tasklist}/tasks/{task}
- `google_tasks_tasks_insert` - POST /tasks/v1/lists/{tasklist}/tasks
- `google_tasks_tasks_list` - GET /tasks/v1/lists/{tasklist}/tasks
- `google_tasks_tasks_patch` - PATCH /tasks/v1/lists/{tasklist}/tasks/{task}
- `google_tasks_tasklists_delete` - DELETE /tasks/v1/users/@me/lists/{tasklist}
- `google_tasks_tasklists_get` - GET /tasks/v1/users/@me/lists/{tasklist}
- `google_tasks_tasklists_insert` - POST /tasks/v1/users/@me/lists
- `google_tasks_tasklists_list` - GET /tasks/v1/users/@me/lists
- `google_tasks_tasklists_patch` - PATCH /tasks/v1/users/@me/lists/{tasklist}
- `google_tasks_tasklists_update` - PUT /tasks/v1/users/@me/lists/{tasklist}

## Examples

```lua
local lists = app.integrations.google_tasks.google_tasks_tasklists_list({ maxResults = 10 })

local task = app.integrations.google_tasks.google_tasks_tasks_insert({
  tasklist = "MDM4NzA1...",
  body = { title = "Follow up", notes = "Send recap email" }
})
```

Responses are decoded Google Tasks JSON responses, or `{ success = true, status = ... }` for successful empty responses such as deletes and clears.

Metadata-derived Lua example

local result = app.integrations.google_tasks.update({})
print(result)

Functions

update Write

Tasks Update (PUT /tasks/v1/lists/{tasklist}/tasks/{task}).

Lua path: app.integrations.google_tasks.update
Full name: google-tasks.google_tasks_tasks_update

Parameter	Type	Required	Description
No parameters.

move Write

Tasks Move (POST /tasks/v1/lists/{tasklist}/tasks/{task}/move).

Lua path: app.integrations.google_tasks.move
Full name: google-tasks.google_tasks_tasks_move

Parameter	Type	Required	Description
No parameters.

delete Write

Tasks Delete (DELETE /tasks/v1/lists/{tasklist}/tasks/{task}).

Lua path: app.integrations.google_tasks.delete
Full name: google-tasks.google_tasks_tasks_delete

Parameter	Type	Required	Description
No parameters.

clear Write

Tasks Clear (POST /tasks/v1/lists/{tasklist}/clear).

Lua path: app.integrations.google_tasks.clear
Full name: google-tasks.google_tasks_tasks_clear

Parameter	Type	Required	Description
No parameters.

get Read

Tasks Get (GET /tasks/v1/lists/{tasklist}/tasks/{task}).

Lua path: app.integrations.google_tasks.get
Full name: google-tasks.google_tasks_tasks_get

Parameter	Type	Required	Description
No parameters.

insert Write

Tasks Insert (POST /tasks/v1/lists/{tasklist}/tasks).

Lua path: app.integrations.google_tasks.insert
Full name: google-tasks.google_tasks_tasks_insert

Parameter	Type	Required	Description
No parameters.

list Read

Tasks List (GET /tasks/v1/lists/{tasklist}/tasks).

Lua path: app.integrations.google_tasks.list
Full name: google-tasks.google_tasks_tasks_list

Parameter	Type	Required	Description
No parameters.

patch Write

Tasks Patch (PATCH /tasks/v1/lists/{tasklist}/tasks/{task}).

Lua path: app.integrations.google_tasks.patch
Full name: google-tasks.google_tasks_tasks_patch

Parameter	Type	Required	Description
No parameters.

tasklists_delete Write

Tasklists Delete (DELETE /tasks/v1/users/@me/lists/{tasklist}).

Lua path: app.integrations.google_tasks.tasklists_delete
Full name: google-tasks.google_tasks_tasklists_delete

Parameter	Type	Required	Description
No parameters.

tasklists_get Read

Tasklists Get (GET /tasks/v1/users/@me/lists/{tasklist}).

Lua path: app.integrations.google_tasks.tasklists_get
Full name: google-tasks.google_tasks_tasklists_get

Parameter	Type	Required	Description
No parameters.

tasklists_insert Write

Tasklists Insert (POST /tasks/v1/users/@me/lists).

Lua path: app.integrations.google_tasks.tasklists_insert
Full name: google-tasks.google_tasks_tasklists_insert

Parameter	Type	Required	Description
No parameters.

tasklists_list Read

Tasklists List (GET /tasks/v1/users/@me/lists).

Lua path: app.integrations.google_tasks.tasklists_list
Full name: google-tasks.google_tasks_tasklists_list

Parameter	Type	Required	Description
No parameters.

tasklists_patch Write

Tasklists Patch (PATCH /tasks/v1/users/@me/lists/{tasklist}).

Lua path: app.integrations.google_tasks.tasklists_patch
Full name: google-tasks.google_tasks_tasklists_patch

Parameter	Type	Required	Description
No parameters.

tasklists_update Write

Tasklists Update (PUT /tasks/v1/users/@me/lists/{tasklist}).

Lua path: app.integrations.google_tasks.tasklists_update
Full name: google-tasks.google_tasks_tasklists_update

Parameter	Type	Required	Description
No parameters.