​

Gmail setup

composer require sanvex/gmail

​

Prerequisites

composer require sanvex/core sanvex/cli sanvex/gmail
php artisan migrate

​

Connect Gmail (built-in routes)

1. Set GMAIL_CLIENT_ID, GMAIL_CLIENT_SECRET, and GMAIL_REDIRECT_URI (configuration). Redirect URI must match Google Console exactly.
2. Visit GET /sanvex/gmail/login.
3. Google redirects to your callback; Sanvex exchanges the code and stores access_token / refresh_token on the global owner.

​

Laravel AI agent

composer require sanvex/laravel-ai

return app(\Sanvex\LaravelAi\Ai\SanvexAi::class)
    ->driver('gmail')
    ->readOnly()
    ->tools();

​

Custom OAuth flow

1. Build the authorize URL (or call $driver->oauth()->getAuthorizationUrl($driver->oauthConfig(), $state)).
2. Exchange the code with $driver->oauth()->exchangeCode($code, $driver->oauthConfig()) — Google requires client id/secret in the POST body (TokenExchangeAuth::RequestBody on OAuthProviderConfig).

use Sanvex\Core\SanvexManager;

$driver = app(SanvexManager::class)
    ->for($user)
    ->resolveDriver('gmail');

$driver->keys()->setOAuthCredentials([
    'access_token' => $tokens['access_token'],
    'refresh_token' => $tokens['refresh_token'] ?? null,
]);

​

Verify

app(SanvexManager::class)
    ->resolveDriver('gmail')
    ->isConfigured();