Integrations
Mudabbir 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 Mudabbir
export MUDABBIR_GOOGLE_CLIENT_ID="your-client-id"export MUDABBIR_GOOGLE_CLIENT_SECRET="your-secret"Authorize
The first time you use a Google tool, Mudabbir will open a browser window for authorization.
Integration Architecture
┌──────────────────┐│ OAuth Framework │ ← Token management, refresh, multi-provider├──────────────────┤│ Token Store │ ← ~/.mudabbir/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└──────────────────┘