GmailTool

pip install "agentor[google]"

from agentor import Agentor
from agentor.tools import GmailTool

gmail_tool = GmailTool(
    credentials_path="./credentials.json"
)

agent = Agentor(
    name="Email Assistant",
    model="gpt-4o-mini",
    tools=[gmail_tool]
)

result = agent.run("Search for unread emails from alice")
print(result)

from agentor.tools import GmailTool

gmail = GmailTool()

# Search for unread emails
result = gmail.search_messages("is:unread", limit=10)

# Search for emails with attachments
result = gmail.search_messages("has:attachment from:alice@example.com")

# Search by date range
result = gmail.search_messages(
    "newer_than:7d",
    after="2024-01-01",
    before="2024-12-31"
)

# Get message metadata
message_data = gmail.get_message("18c5f7a2b3d4e5f6")

# Get full message body
body = gmail.get_message_body(
    message_id="18c5f7a2b3d4e5f6",
    prefer="text",
    limit=10000
)

# Missing credentials
try:
    gmail = GmailTool(credentials_path="missing.json")
except FileNotFoundError as e:
    print(e)  # Credentials file not found

# Invalid message ID
result = gmail.get_message("invalid-id")
print(result)  # Error: ...