Integrations
PocketPaw integrates with popular services to extend its capabilities beyond chat.
Available Integrations
OAuth Framework
Built-in OAuth 2.0 framework for secure authentication with Google and Spotify.
Gmail
Search, read, and send emails through your Gmail account.
Google Calendar
List, create, and search calendar events.
Google Drive
List, download, upload, and share files in Google Drive.
Google Docs
Read, create, and search Google Docs.
Spotify
Search music, control playback, and manage playlists.
Search posts, read threads, and browse trending content. No auth needed.
MCP Servers
Connect Model Context Protocol servers to extend capabilities infinitely.
Google Integrations Setup
All Google integrations (Gmail, Calendar, Drive, Docs) share the same OAuth framework:
Create Google Cloud project
Go to console.cloud.google.com and create a project.
Enable APIs
Enable the Gmail API, Calendar API, Drive API, and Docs API.
Create OAuth credentials
Create OAuth 2.0 client credentials (Desktop app type).
Configure PocketPaw
export POCKETCLAW_GOOGLE_CLIENT_ID="your-client-id"export POCKETCLAW_GOOGLE_CLIENT_SECRET="your-secret"Authorize
The first time you use a Google tool, PocketPaw will open a browser window for authorization.
Integration Architecture
┌──────────────────┐│ OAuth Framework │ ← Token management, refresh, multi-provider├──────────────────┤│ Token Store │ ← ~/.pocketclaw/tokens/├──────────────────┤│ API Clients │ ← gmail.py, gcalendar.py, gdrive.py, etc.├──────────────────┤│ Tool Layer │ ← tools/builtin/gmail.py, calendar.py, etc.├──────────────────┤│ Tool Registry │ ← Registered with policy system└──────────────────┘