Connecting Gmail & Google Calendar

Connect your Google account so your agent can send emails, read your inbox, and manage your calendar events. This guide walks you through both the OAuth connection and the app password setup needed for full email access.

Early Access Notice

Gmail and Google Calendar integration is in early access (beta). If you want to try it, reach out to us at [email protected] or use the chat widget on the dashboard and we will send you an invitation.

During setup, you may see an "unverified app" warning during the Google sign-in step. This is expected while Google reviews our app. Click Advanced then Go to agento.host to continue.

Prerequisites

Before you start, make sure you have:

• An Agento account with at least one agent
• A Gmail or Google Workspace email account

How It Works

Connecting Google to Agento is a two-step process:

Step	What it enables
Step 1: OAuth connection	Send emails on your behalf + access your Google Calendar
Step 2: App password	Read and search your email inbox

The OAuth connection alone lets your agent send emails and manage your calendar. To also let your agent read your emails, you need to set up an app password (explained below).

Step 1: Connect Your Google Account (OAuth)

1. Open the Agento dashboard
2. Go to Settings then Integrations
3. Find the Gmail section
4. Click Connect Gmail Account
5. A Google sign-in window will appear. Select your Google account and grant the requested permissions
6. You will see a warning that Google hasn't verified this app. Click Advanced then Go to agento.host to continue
7. Once approved, your Gmail account appears as connected

This connection gives your agent the ability to send emails from your address and access your Google Calendar.

Step 2: Set Up an App Password (for Reading Emails)

To let your agent read your emails, you need to generate a Google app password and add it to Agento.

1. In the Gmail integration section, click the option to set up an App Password
2. You will see your connected email address and a link to the Google app passwords page
3. Click the link to open Google's app password page (or go to myaccount.google.com/apppasswords)
4. Give the app password a name (e.g. "agento") and click Create
5. Google will show you a generated password. Copy it immediately — you will not be able to see it again
6. Go back to Agento and paste the app password into the field
7. Click Test Connection to verify it works
8. Click Connect

Once both steps are complete, all three capabilities are enabled: reading emails, sending emails, and calendar access.

Give Your Agent Access

Connecting your Google account makes it available on your Agento account, but you still need to grant each agent permission to use it.

1. Go to your agent's page
2. Click Integrations
3. Select a connected email account from the dropdown — choose the app password option if you want your agent to be able to read messages
4. Enable the permissions you need
5. Click Add

You can enable or disable individual permissions based on what you want your agent to do.

What Your Agent Can Do

Once connected and granted access, your agent gets these capabilities:

Read Emails (requires app password)

Your agent can search your inbox and read your messages. Ask it things like:

• "What new emails do I have?"
• "Find all emails from [email protected] this week"
• "Show me unread messages about the Q1 report"
• "Which emails are important and need my attention?"

Send Emails (OAuth connection)

Your agent can compose and send emails from your address:

• "Reply to Sarah's last email and confirm the meeting"
• "Send a follow-up to the team about the project deadline"
• "Draft an email to [email protected] about the proposal"

Calendar (OAuth connection)

Your agent can check your schedule and manage events:

• "What meetings do I have tomorrow?"
• "Am I free Thursday afternoon?"
• "Schedule a 30-minute call with Sarah tomorrow at 2pm"
• "Move my Friday standup to 10am"

Managing Permissions

You can change permissions at any time from your agent's Integrations tab. Toggle individual permissions on or off, or remove the account entirely by clicking the remove button.

Changes take effect on the agent's next message. No restart needed.

Disconnecting

To fully disconnect a Google account:

1. Go to Settings then Integrations
2. Click the disconnect button next to the account

This revokes Agento's access tokens and removes the synced email cache. Your emails and calendar events in Google are not affected.

Troubleshooting

"This app isn't verified" warning: This is expected during our early access period. Click Advanced then Go to agento.host (unsafe) to continue. If you still can't connect, contact us at [email protected] and we will add you to the approved test users list.

Agent can't read emails: Make sure you completed Step 2 (app password setup). The OAuth connection alone does not grant read access. Also verify that you selected the app password account option when adding the integration to your agent.

App password not working: Verify the password was copied correctly with no extra spaces. You can generate a new app password from Google and replace the old one in Agento. Use Test Connection to verify before saving.

Agent can't send emails: Make sure the send permission is enabled for that account in your agent's Integrations tab.

Calendar tools not working: Make sure the calendar permissions are enabled in your agent's Integrations tab.

Agent doesn't use the email account: Make sure you granted the account to your specific agent in the agent's Integrations tab. Connecting an account on the Settings page makes it available, but each agent needs explicit access.