Gmail

​

Connect

1. In Google Cloud Console, enable the Gmail API, configure the OAuth consent screen, and create OAuth credentials for a Desktop app.
2. Import the downloaded JSON with the setup assistant in Settings → Integrations. Arden stores it as ~/.arden/gmail_credentials.json.
3. Open the Gmail card and click Connect. Arden opens a local browser consent flow and saves an account-specific token under ~/.arden/.

​

Manual setup

~/.arden/gmail_credentials.json

curl -X POST http://localhost:6877/google/gmail/connect \
  -H "Authorization: Bearer $ARDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X PATCH http://localhost:6877/config \
  -H "Authorization: Bearer $ARDEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integrations":{"gmail":true}}'

​

Google verification note

​

Configuration

​

Available tools

​

Troubleshooting

• Missing credentials – import a Google OAuth Desktop app JSON; Web application credentials are rejected.
• Access denied / test user – if your OAuth app is still in Testing mode, add your Google account as a test user.
• API not enabled / 403 – enable the Gmail API in the same Google Cloud project.
• Missing scope – disconnect and reconnect Gmail.

​

Multiple accounts