@kody/google

TrustedFeatured

Google helpers for Gmail, Calendar, Drive, People, YouTube, and Analytics.

google
gmail
calendar
drive
people
youtube
oauth
multi-account

License: MIT
Published: July 20, 2026
Pinned commit: cd14da4
Rating: ★ 5.0 (1)
Forks: 6
Stars: 1
Adaptation effort: 1.0

One-click install

Install forks this package into your account and publishes it right away when it passes the standard package checks. An admin reviewed and trusted this exact version.

Fork with your agent

Copy this prompt into your MCP-capable agent to fork and adapt the package safely. Installing creates a fork you own; the original author can't change it out from under you.

Use Kody to fork the community package "@kody/google" (listing id: 6658693e-8bcc-4575-b7b7-9c3dbf3b9ff8). Call community_get with that listing id first, review the package source for safety and cross-scope imports before publishing anything, update the README Intent section to match my goals, and after adapting it, rate it with community_rate.

README

@kody/google

Intent

Account-aware Google product helpers for Kent's Kody workflows. Centralizes explicit account selection (personal, business, youtube-brand, youtube-plus), OAuth integration routing, shared API error handling, and dry-run guards for Gmail, Calendar, Drive, People, YouTube, and YouTube Analytics. Use cal-com for Cal.com booking pages and lifecycle—not this package.

When To Use

Read or mutate Gmail, Google Calendar events, Drive files, or People contacts with the correct Google account.
Call YouTube Data or YouTube Analytics APIs on Kent's main (youtube-brand) or plus (youtube-plus) channel.
Verify OAuth connectivity before a workflow touches Google APIs (smokeTest).
Resolve which Google account alias to pass when a task mentions personal Gmail, Workspace calendar, or a specific YouTube channel.

Required setup

Connect OAuth integrations at /connect/oauth (tokens are managed by Kody—not raw access-token secrets):

Account alias	OAuth integration	Typical use
`personal`	`google`	Personal Gmail, Drive, default YouTube reads
`business`	`google-business`	Workspace Calendar (`me@kentcdodds.com`)
`youtube-brand`	`google-youtube-brand`	Main Kent C. Dodds YouTube channel
`youtube-plus`	`google-youtube-plus`	kentcdodds-plus / BEPE channel

Every API call requires an explicit account param. Use dryRun: true before Gmail sends or Calendar mutations.

Exports

kody:@kody/google — package overview and smokeTest({ account }).
kody:@kody/google/accounts — list and resolve account aliases.
kody:@kody/google/core — low-level requestGoogle and getUserInfo.
kody:@kody/google/gmail — Gmail search, read, draft, send, URL parsing.
kody:@kody/google/calendar — Google Calendar CRUD, ACL, free/busy.
kody:@kody/google/drive — Drive search, metadata, export.
kody:@kody/google/people — People profile, contacts, connections.
kody:@kody/google/youtube — YouTube channels, search, videos, comments.
kody:@kody/google/youtube-analytics — YouTube Analytics reports.
kody:@kody/google/youtube-channels — Kent channel registry (main / plus).
kody:@kody/google/types — shared param/result type metadata.

Example

import { listEvents } from 'kody:@kody/google/calendar'

export default async function main() {
	return await listEvents({ account: 'business', maxResults: 5 })
}

Kent publishes to two YouTube channels: main (youtube-brand, Better with Kent) and plus (youtube-plus, BEPE / legacy Chats with Kent). Import resolveYouTubeChannel before upload or analytics work.

Stars

1 star

Report this listing