Connect your nself backend to Google Workspace. Read and send Gmail, manage Google Calendar events, browse Google Drive files, and read and write Google Sheets, all through a single OAuth flow stored server-side.
nself-google is part of the ɳClaw bundle. Set your key with nself license set nself_pro_... before installing.
nself license set nself_pro_...
nself plugin install google
nself build
nself starthttps://your-domain.com/google/auth/callback..env.| Variable | Required | Description |
|---|---|---|
PLUGIN_GOOGLE_CLIENT_ID | Yes | OAuth 2.0 Client ID from Google Cloud Console |
PLUGIN_GOOGLE_CLIENT_SECRET | Yes | OAuth 2.0 Client Secret from Google Cloud Console |
PLUGIN_GOOGLE_CLIENT_ID=123456789-xxxxx.apps.googleusercontent.com
PLUGIN_GOOGLE_CLIENT_SECRET=GOCSPX-xxxxx# Step 1: Get the OAuth URL (include the user_id you want to link)
curl "http://127.0.0.1:3719/google/auth/url?user_id=user-uuid"
# Returns: { "url": "https://accounts.google.com/o/oauth2/..." }
# Step 2: Redirect the user to that URL
# Step 3: After consent, Google redirects to /google/auth/callback
# The plugin stores the refresh token automatically, no further action needed# List Gmail messages
curl "http://127.0.0.1:3719/google/gmail/messages?user_id=user-uuid"
# List Calendar events
curl "http://127.0.0.1:3719/google/calendar/events?user_id=user-uuid"
# List Drive files
curl "http://127.0.0.1:3719/google/drive/files?user_id=user-uuid"
# Read a Google Sheet
curl "http://127.0.0.1:3719/google/sheets/SPREADSHEET_ID?user_id=user-uuid"| Endpoint | Method | Description |
|---|---|---|
/google/auth/url | GET | Get OAuth consent URL for a user |
/google/auth/callback | GET | OAuth callback, stores refresh token (called by Google) |
/google/gmail/messages | GET | List Gmail messages for a user |
/google/gmail/send | POST | Send an email via Gmail |
/google/calendar/events | GET | List upcoming calendar events |
/google/calendar/events | POST | Create a calendar event |
/google/drive/files | GET | List Drive files and folders |
/google/sheets/:id | GET | Read rows from a Google Sheet |
/google/sheets/:id | POST | Append rows to a Google Sheet |
/google/health | GET | Check plugin health and OAuth configuration |
| API | Capabilities | Scope required |
|---|---|---|
| Gmail | Read messages, send email, manage labels | gmail.modify |
| Google Calendar | List and create events across all calendars | calendar |
| Google Drive | List files, read metadata, download files | drive.readonly |
| Google Sheets | Read and append rows in any spreadsheet | spreadsheets |
The plugin requests all scopes during the initial OAuth consent. Users see a single permissions screen covering all enabled APIs.
nself plugin remove googlePort: 3719 | Bundle: ɳClaw ($0.99/mo) or ɳSelf+ ($3.99/mo) | Last Updated: April 2026 | Plugin Version 1.0.12