AI Google Calendar Assistant powered by n8n and OpenAI

Unlock Conversational Calendar Management with this AI Agent

This AI Agent transforms how you interact with your Google Calendar. Simply chat with the agent in natural language, and it will intelligently understand your requests to create new events or retrieve existing ones. Powered by OpenAI's advanced language models (like GPT-4o), this n8n workflow acts as your personal calendar assistant, streamlining your scheduling and keeping you organized.

It's designed to understand context, ask clarifying questions if needed (e.g., for date ranges or event details), and confirm actions before execution, ensuring accuracy and a smooth user experience. The agent is aware of the current date, allowing for intuitive requests like "schedule a meeting for next Monday."

Key Features & Benefits

• Conversational Calendar Control: Manage your Google Calendar through simple chat messages via n8n's chat interface or your integrated chat platform.
• AI-Powered Event Creation: Tell the agent what event to create, including title, description, start, and end times. It will proactively gather missing details and can suggest content.
• Intelligent Event Retrieval: Ask for events within specific date ranges (e.g., "What's on my calendar for next week?" or "Find events about 'project alpha' last month").
• Natural Language Understanding: Leverages OpenAI (default GPT-4o) to interpret diverse user inputs and extract necessary information like dates, times, and event specifics using advanced tool-calling capabilities.
• Dynamic Date Awareness: The agent inherently knows the current date, making relative date requests (e.g., "tomorrow", "next Friday") easy to process.
• Contextual Memory: Remembers recent parts of the conversation for more natural, follow-up interactions (configurable window buffer memory).
• Language Agnostic Interaction: The agent is prompted to match the user's language, offering a more personalized experience (relies on the LLM's multilingual capabilities).
• Extensible & Customizable: Easily modify the system prompt in the Langchain Agent node to fine-tune the agent's personality, add more specific instructions, or integrate additional tools through n8n.

• An n8n instance (Cloud or self-hosted).
• OpenAI API Key with access to a suitable model (e.g., gpt-4o, gpt-4o-mini recommended, must support tool calling).
• Google Calendar API credentials (OAuth2) configured in n8n for the account you want to manage.

1. Download the n8n workflow JSON file.
2. Import the workflow into your n8n instance.
3. The workflow is triggered by the '@n8n/n8n-nodes-langchain.chatTrigger' node by default. You can use n8n's embeddable chat interface or replace this trigger with alternatives like Slack, Discord, or a Webhook node connected to your custom chat UI (e.g., Streamlit, OpenWebUI).
4. Configure the 'OpenAI Chat Model' node: Select your OpenAI credential from the dropdown and choose your preferred model (default is gpt-4o). Ensure the selected model supports tool calling.
5. Configure the 'Google Calendar - Get Events' tool node: Select your Google Calendar OAuth2 credential and, if necessary, specify the calendar ID you want the agent to query.
6. Configure the 'Google Calendar - Create events' tool node: Select your Google Calendar OAuth2 credential and, if necessary, specify the calendar ID where the agent should create events.
7. (Optional) Review and customize the system prompt in the 'Calendar AI Agent' node to tailor the agent's behavior, language, or specific instructions for handling events.
8. (Optional) Adjust the 'Window Buffer Memory' node settings if you need a longer or shorter conversation history for context. For persistent memory, consider replacing it with a database-backed memory like Postgres chat memory.
9. Activate the workflow and start interacting with your AI Calendar Assistant via the configured chat interface or trigger.