Google Calendar

Query events, check availability, and create meetings.

Query events, check availability, and create meetings. By default, exposes query_calendar for reading. Enable write=True to also expose update_calendar for creating and modifying events.

from agno.agent import Agent
from agno.context.calendar import GoogleCalendarContextProvider

calendar = GoogleCalendarContextProvider()

agent = Agent(
    model=...,
    tools=calendar.get_tools(),
)

agent.print_response("What meetings do I have tomorrow?")

Authentication

Same as Gmail - OAuth or service account.

OAuth (Personal)

export GOOGLE_CLIENT_ID=...
export GOOGLE_CLIENT_SECRET=...
export GOOGLE_PROJECT_ID=...

Token cached to calendar_token.json.

Service Account

export GOOGLE_SERVICE_ACCOUNT_FILE=/path/to/service-account.json
export GOOGLE_DELEGATED_USER=[e-mail]  # Optional

Without delegated_user, operates on the service account’s own calendar.

Configuration

Parameter	Type	Default	Description
id	str	"calendar"	Tools become query_<id> and update_<id>.
model	Model	None	Model for sub-agents.
read	bool	True	Expose query_calendar.
write	bool	False	Expose update_calendar. Disabled by default for safety.
mode	ContextMode	default	See Mode.

Tools Exposed

Tool	Description
query_calendar	List events, search events, check availability, find free slots. Always exposed.
update_calendar	Create events, update events, delete events. Requires write=True.

Example queries

Query	What happens
”What’s on my calendar this week?”	Lists events with time range
”When am I free on Friday afternoon?”	Checks availability
”Find all meetings about the product launch”	Searches event titles/descriptions
”Schedule a 30-min sync with Alice tomorrow at 2pm”	Creates event (requires write=True)

Resources

GoogleCalendarTools Reference

All methods and OAuth setup

Cookbook Example

Working example