Skip to main content

​
Setup

lukan google-auth
This initiates a browser-based OAuth flow.

​
Requirements

A Google Cloud project with OAuth 2.0 credentials. Required scopes:
  • Sheets
  • Calendar
  • Docs
  • Drive

​
Available Tools

​
Sheets

ToolDescription
SheetsReadRead spreadsheet data (A1 notation)
SheetsWriteWrite/append spreadsheet data
SheetsCreateCreate a new spreadsheet

​
Calendar

ToolDescription
CalendarListList calendar events
CalendarCreateCreate a calendar event
CalendarUpdateUpdate a calendar event

​
Docs

ToolDescription
DocsReadRead a Google Doc
DocsCreateCreate a Google Doc
DocsUpdateUpdate a Google Doc

​
Drive

ToolDescription
DriveListList Drive files
DriveDownloadDownload a file from Drive

​
Token Storage

Tokens are stored in ~/.config/lukan/credentials.json and auto-refresh when expired.

​
Usage Example

// Read a spreadsheet
SheetsRead({ spreadsheetId: "abc123", range: "Sheet1!A1:C10" })

// Create a calendar event
CalendarCreate({
  summary: "Team meeting",
  start: "2025-03-15T10:00:00-05:00",
  end: "2025-03-15T11:00:00-05:00",
  description: "Weekly sync"
})

// Create a doc
DocsCreate({ title: "Project Notes", content: "# Notes\n\nInitial content" })