Gmail

Gmail enables an Agent to interact with Gmail, allowing it to read, search, send, and manage emails.

Prerequisites

The Gmail toolkit requires Google API client libraries and proper authentication setup. Install the required dependencies:

pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

You’ll also need to set up Google Cloud credentials:

Go to Google Cloud Console
Create a project or select an existing one
Enable the Gmail API
Create OAuth 2.0 credentials
Set up environment variables:

export GOOGLE_CLIENT_ID=your_client_id_here
export GOOGLE_CLIENT_SECRET=your_client_secret_here
export GOOGLE_PROJECT_ID=your_project_id_here
export GOOGLE_REDIRECT_URI=http://localhost  # Default value

Example

cookbook/tools/gmail_tools.py

from agno.agent import Agent
from agno.tools.gmail import GmailTools

agent = Agent(tools=[GmailTools()], show_tool_calls=True)
agent.print_response("Show me my latest 5 unread emails", markdown=True)

Toolkit Params

Parameter	Type	Default	Description
`get_latest_emails`	`bool`	`True`	Enable retrieving latest emails from inbox
`get_emails_from_user`	`bool`	`True`	Enable getting emails from specific senders
`get_unread_emails`	`bool`	`True`	Enable fetching unread emails
`get_starred_emails`	`bool`	`True`	Enable retrieving starred emails
`get_emails_by_context`	`bool`	`True`	Enable searching emails by context
`get_emails_by_date`	`bool`	`True`	Enable retrieving emails within date ranges
`create_draft_email`	`bool`	`True`	Enable creating email drafts
`send_email`	`bool`	`True`	Enable sending emails
`search_emails`	`bool`	`True`	Enable searching emails
`creds`	`Credentials`	`None`	Pre-fetched OAuth credentials
`credentials_path`	`str`	`None`	Path to credentials file
`token_path`	`str`	`None`	Path to token file
`scopes`	`List[str]`	`None`	Custom OAuth scopes
`port`	`int`	`None`	Port to use for OAuth authentication

Toolkit Functions

Function	Description
`get_latest_emails`	Get the latest X emails from the user’s inbox
`get_emails_from_user`	Get X number of emails from a specific sender
`get_unread_emails`	Get the latest X unread emails
`get_starred_emails`	Get X number of starred emails
`get_emails_by_context`	Get X number of emails matching a specific context
`get_emails_by_date`	Get emails within a specific date range
`create_draft_email`	Create and save an email draft
`send_email`	Send an email immediately
`search_emails`	Search emails using natural language queries

Developer Resources

View Tools
View Cookbook

Introduction

Concepts

Other

How to

Prerequisites

Example

Toolkit Params

Toolkit Functions

Developer Resources

​Prerequisites

​Example

​Toolkit Params

​Toolkit Functions

​Developer Resources

Prerequisites

Example

Toolkit Params

Toolkit Functions

Developer Resources