> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lukan.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace

> Connect Lukan to Sheets, Calendar, Docs, and Drive.

## Setup

```bash theme={null}
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

| Tool           | Description                         |
| -------------- | ----------------------------------- |
| `SheetsRead`   | Read spreadsheet data (A1 notation) |
| `SheetsWrite`  | Write/append spreadsheet data       |
| `SheetsCreate` | Create a new spreadsheet            |

### Calendar

| Tool             | Description             |
| ---------------- | ----------------------- |
| `CalendarList`   | List calendar events    |
| `CalendarCreate` | Create a calendar event |
| `CalendarUpdate` | Update a calendar event |

### Docs

| Tool         | Description         |
| ------------ | ------------------- |
| `DocsRead`   | Read a Google Doc   |
| `DocsCreate` | Create a Google Doc |
| `DocsUpdate` | Update a Google Doc |

### Drive

| Tool            | Description                |
| --------------- | -------------------------- |
| `DriveList`     | List Drive files           |
| `DriveDownload` | Download a file from Drive |

## Token Storage

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

## Usage Example

```typescript theme={null}
// 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" })
```