concinno-skills-google

Google ecosystem agent skills for Concinno. Native Python API first, MCP fallback optional.

Status

MVP (0.1.0) — GoogleCalendar only. Drive / Gmail / YouTube Data will follow in subsequent minor releases under the same entry-point group so no Concinno upgrade is required when new tools land.

Install

pip install concinno-skills-google

google-api-python-client and google-auth are hard dependencies (the tool is useless without them) and will be pulled in automatically.

OAuth setup

This package does not run an interactive OAuth flow — tokens are a one-shot user responsibility. Use any of the standard Google quickstart flows to produce an authorized-user token JSON, then make it visible to Concinno via either of:

Option A — drop the file (simplest):

mkdir -p ~/.concinno
cp path/to/your/token.json ~/.concinno/google_token.json

Option B — Concinno CredentialStore (preferred when you already use it for other secrets):

from concinno.core.credentials import get_default_store

store = get_default_store()
store.set("google_oauth_token", open("token.json").read())

Or persist it via the config file:

// ~/.concinno/credentials.json
{
  "google_oauth_token": "{...authorized-user token JSON as a string...}"
}

Expired access tokens are refreshed automatically; the refreshed JSON is written back to whichever source provided it.

Usage via Concinno ToolRegistry

When the consumer sets CONCINNO_LOAD_PLUGINS=1, the default registry auto-mounts GoogleCalendar:

import os
os.environ["CONCINNO_LOAD_PLUGINS"] = "1"

from concinno.tools.registry import get_default_registry

reg = get_default_registry()
assert "GoogleCalendar" in reg.list_deferred()

tool = reg.get("GoogleCalendar")
events = tool.call(
    action="list",
    time_min="2026-04-22T00:00:00Z",
    time_max="2026-04-23T00:00:00Z",
    max_results=50,
)

Direct Python usage

No registry round-trip required; instantiate directly:

from concinno_skills_google import GoogleCalendar

cal = GoogleCalendar()

# List
events = cal.call(
    action="list",
    calendar_id="primary",
    time_min="2026-04-22T00:00:00Z",
)

# Create
created = cal.call(
    action="create",
    event={
        "summary": "Deep work block",
        "start": {"dateTime": "2026-04-22T14:00:00+08:00"},
        "end":   {"dateTime": "2026-04-22T16:00:00+08:00"},
    },
)

# Delete
cal.call(action="delete", event_id=created["id"])

All methods return either a plain list[dict] (for list) or a small status dict. On failure they return {"error": "..."} rather than raising — same shape as the other Concinno built-in tools.

License

Apache-2.0. See LICENSE in the Concinno monorepo.