{"id":"ITH6r6UYtlCyUcpj","meta":{"instanceId":"workflow-aa71f92b","versionId":"1.0.0","createdAt":"2025-09-29T07:07:45.305640","updatedAt":"2025-09-29T07:07:45.305662","owner":"n8n-user","license":"MIT","category":"automation","status":"active","priority":"high","environment":"production"},"name":"AI Agent : Google calendar assistant using OpenAI","nodes":[{"id":"trigger-8d44e1b2","name":"Manual Trigger","type":"n8n-nodes-base.manualTrigger","typeVersion":1,"position":[100,100],"parameters":{}},{"id":"2e670a54-f789-4c8b-abba-ae35c458f5ed","name":"When chat message received","type":"n8n-nodes-base.noOp","position":[-280,0],"webhookId":"5308edc9-738b-4aae-a789-214e2392579a","parameters":{"options":{}},"typeVersion":1,"notes":"This chatTrigger node performs automated tasks as part of the workflow."},{"id":"96bf895f-a18c-4a4c-bc26-3ec5d2372de5","name":"OpenAI Chat Model","type":"n8n-nodes-base.noOp","position":[160,820],"parameters":{"model":"gpt-4o","options":{}},"credentials":{"openAiApi":{"id":"","name":"OpenAi"}},"typeVersion":1,"notes":"This lmChatOpenAi node performs automated tasks as part of the workflow."},{"id":"270176df-9c2d-4f1a-b017-9349cb249341","name":"Window Buffer Memory","type":"n8n-nodes-base.noOp","position":[580,820],"parameters":{},"typeVersion":1,"notes":"This memoryBufferWindow node performs automated tasks as part of the workflow."},{"id":"5cdece35-bd69-4c77-b240-963df8781d64","name":"Google Calendar - Get Events","type":"n8n-nodes-base.googleCalendarTool","position":[960,800],"parameters":{"options":{"timeMax":"={{ $fromAI('end_date') }}","timeMin":"={{ $fromAI('start_date') }}"},"calendar":{"__rl":true,"mode":"list","value":"","cachedResultName":""},"operation":"getAll","descriptionType":"manual","toolDescription":"Use this tool when you’re asked to retrieve events data."},"credentials":{"googleCalendarOAuth2Api":{"id":"","name":"Google Calendar account"}},"typeVersion":1.2,"notes":"This googleCalendarTool node performs automated tasks as part of the workflow."},{"id":"634e6472-099c-4f0e-b9eb-67956c4881b8","name":"Google Calendar - Create events","type":"n8n-nodes-base.googleCalendarTool","position":[1380,800],"parameters":{"end":"={{ $fromAI('end_date') }} ","start":"={{ $fromAI('start_date') }} ","calendar":{"__rl":true,"mode":"list","value":"","cachedResultName":""},"descriptionType":"manual","toolDescription":"Use this Google Calendar tool when you are asked to create an event.","additionalFields":{"summary":"={{ $fromAI('event_title') }} ","attendees":[],"description":"={{ $fromAI('event_description') }} "},"useDefaultReminders":false},"credentials":{"googleCalendarOAuth2Api":{"id":"","name":"Google Calendar account"}},"typeVersion":1.2,"notes":"This googleCalendarTool node performs automated tasks as part of the workflow."},{"id":"5c93e130-29d5-489b-84ea-3e31f5849b3a","name":"Sticky Note","type":"n8n-nodes-base.stickyNote","position":[-380,-380],"parameters":{"color":7,"width":320,"height":560,"content":"## Chat trigger - When a message is received\n\nThis node is the **entry point of the workflow**. \nIt triggers the workflow whenever a message is sent to the **chat interface**.\n\nOptions with n8n:\n- **Embed the chat interface** anywhere you want.\n- Use a **webhook node** instead of this node to connect with interfaces like **[Streamlit]({{ $env.WEBHOOK_URL }} or **[OpenWebUI]({{ $env.WEBHOOK_URL }}\n- Use nodes for communication platforms (**Slack**, **Teams**, **Discord**, etc.) if you know how to configure them.\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"a1e850b4-d0fe-417c-8e1e-13fb4cdbb0a8","name":"Sticky Note1","type":"n8n-nodes-base.stickyNote","position":[60,-380],"parameters":{"color":7,"width":1520,"height":560,"content":"## Tools Agent - Calendar AI Agent\n\nThis **node** configures the **AI agent** for interaction with Google Calendar. \nIt includes the following features:\n\n- A **prompt source**: This is the user message derived from the chat input of the preceding node (`When chat message is received`).\n- A **system message**: This defines the system prompt to guide the AI agent's behavior. It incorporates the variable `{{ DateTime.local().toFormat('cccc d LLLL yyyy') }`, allowing the AI agent to determine the current date and interact with Google Calendar accordingly. For example, the agent can understand a request like \"Create an event called 'n8n workflow review' for next Tuesday.\"\n\n\nn8n nodes come with built-in **guardrails**, ensuring that if the user requests tasks outside the AI agent's setup, it may not function as intended. (Feel free to test it!)\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"9b259245-5fd5-4798-973e-bc6aa15da20f","name":"Calendar AI Agent","type":"n8n-nodes-base.noOp","position":[580,0],"parameters":{"text":"={{ $json.chatInput }}","options":{"systemMessage":"=You are a Google Calendar assistant.\nYour primary goal is to assist the user in managing their calendar effectively using two tools: Event Creation and Event Retrieval. Always base your responses on the current date: \n{{ DateTime.local().toFormat('cccc d LLLL yyyy') }}.\nGeneral Guidelines:\nIf the user's initial message is vague (e.g., \"hello\" or a generic greeting) or does not specify a request, explain your capabilities clearly:\nExample: \"Hello! I can help you manage your Google Calendar. You can ask me to create an event or retrieve event data. What would you like me to do?\"\nIf the user specifies a request in their first message, begin preparing to use the appropriate tool:\nFor event creation, gather necessary details like start date, end date, title, and description.\nFor event retrieval, ask for the date range or time period they want to query.\nTool: Event Creation\nWhen asked to create an event:\n\nRequest the start and end dates/times from the user.\nDate format: YYYY-MM-DD HH:mm:ss\nCollect the following information:\nstart_date: Exact start date and time of the event.\nend_date: Exact end date and time of the event.\nevent_title: Event title in uppercase. Suggest one if not provided.\nevent_description: Generate a brief description and present it for confirmation.\nTool: Event Retrieval\nWhen asked to retrieve events:\n\nAsk for the date range or period they are interested in. Examples:\nFor \"last week,\" retrieve events from Monday of the previous week to Friday of the same week.\nFor \"today,\" use the current date.\nFormat the date range:\nstart_date: Start date and time in YYYY-MM-DD HH:mm:ss.\nend_date: End date and time in YYYY-MM-DD HH:mm:ss.\nKey Behaviors:\nClarity: Provide a clear and helpful introduction when the user's request is unclear.\nValidation: Confirm details with the user before finalizing actions.\nAdaptation: Handle varying levels of detail in requests (e.g., \"Add a meeting for next Monday morning\" or \"Retrieve my events for this weekend\").\nProactivity: Offer suggestions to fill in missing details or clarify ambiguous inputs.\nLanguage Matching: Ensure all interactions, including event titles, descriptions, and messages, are in the user's language to provide a seamless experience."},"promptType":"define"},"typeVersion":1,"notes":"This agent node performs automated tasks as part of the workflow."},{"id":"b902a7d0-c2ca-4ab9-9f2a-047b9ccb1678","name":"Sticky Note2","type":"n8n-nodes-base.stickyNote","position":[60,240],"parameters":{"color":5,"width":320,"height":720,"content":"## OpenAI chat model\n\nThis node specifies the chat model used by the agent. \nIn the template, the **default LLM is gpt-4o** for its high relevance.\n\nOther options:\n- You can **try gpt-4o-mini**, which is more cost-effective.\n- You can also choose **other LLM providers besides OpenAI**, but make sure the LLM you select **supports tool-calling**.\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"c67e1e1b-ef9a-4fec-a860-4ec6b7439df6","name":"Sticky Note3","type":"n8n-nodes-base.stickyNote","position":[460,240],"parameters":{"color":5,"width":320,"height":720,"content":"## Window buffer memory\n\nThis node manages the **memory** of the agent, specifically the **context window length** for chat history. \nThe default is set to 5 messages.\n\nNote: \nThe **memory** is **temporary**. If you want to **store conversations with the agent**, you should use other nodes like **Postgres chat memory**. \nThis can be easily set up with services like **[Supabase]({{ $env.WEBHOOK_URL }}\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"bf719d53-e21b-4bd5-9443-c24d008f732b","name":"Sticky Note4","type":"n8n-nodes-base.stickyNote","position":[860,240],"parameters":{"color":5,"width":320,"height":720,"content":"## Google Calendar - Get Events\n\nThis sub-node is a tool used by the AI agent. \nIts purpose is to **retrieve events based on the user input**. \nFor example: *\"Can you give me the events from last week about internal process ?\"*\n\nThe AI agent is designed to **use this tool only** when it has a **date range**. \nIf the user hasn’t provided a date range, the **AI agent will ask the user** for it.\n\nThe **variables** `{{ $fromAI('start_date') }}` and `{{ $fromAI('end_date') }}` are **dynamically filled by the AI**.\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"e94eb1f8-df42-414b-9bec-9e6991a5a832","name":"Sticky Note5","type":"n8n-nodes-base.stickyNote","position":[1260,240],"parameters":{"color":5,"width":320,"height":720,"content":"## Google Calendar - Create Events\n\nThis sub-node is a tool used by the AI agent. \nIts purpose is to **create events based on the user input**. \nFor example: \"Can you create an event 'Quarter revenue meeting' on [date] from [hour] to [hour] ?\"\n\nThe AI agent is designed to **use this tool only** when it has a **date range**. \nIf the user hasn’t provided a **date range**, the AI agent will **ask the user** for it. \nThe variables `{{ $fromAI('start_date') }}` and `{{ $fromAI('end_date') }}` are dynamically filled by the AI.\n\nBefore creating the event, the AI agent will **confirm with the user** if the **title** and **description** of the event are correct. \nThe variables used for this are:\n- `{{ $fromAI('event_title') }}`\n- `{{ $fromAI('event_description') }}`\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"707c011c-c822-4922-8ef7-c4368947d179","name":"Sticky Note6","type":"n8n-nodes-base.stickyNote","position":[860,1000],"parameters":{"color":4,"width":720,"height":380,"content":"## Having fun with it ? Here’s how to level up this AI agent ! \n\nThis workflow demonstrates **how easily you can set up an AI agent to call tools** for you using **n8n**. \nThe tasks here are **useful but very basic**. \n\nIf you want to **enhance the tool-calling capabilities**, consider the following:\n\n- Explore the **\"options\"** in the Google Calendar nodes to see additional features you can use. \n For example, let the AI agent add attendees to events it creates.\n\n- Implement the AI agent with your **teammates and link it to each calendar**. \n Use a `{{ $fromAI('') }}` variable for the calendar field and refine the prompts to suit your needs.\n\n- Add **more actions** for the AI agent to perform with the **Google Calendar API**, expanding its functionality.\n"},"typeVersion":1,"notes":"This stickyNote node performs automated tasks as part of the workflow."},{"id":"error-5c983810","name":"Error Handler","type":"n8n-nodes-base.stopAndError","typeVersion":1,"position":[1000,400],"parameters":{"message":"Workflow execution error","options":{}}}],"active":false,"settings":{"timezone":"UTC","callerPolicy":"workflowsFromSameOwner","executionOrder":"v1","saveManualExecutions":true,"errorWorkflow":null,"executionTimeout":3600,"maxExecutions":1000,"retryOnFail":true,"retryCount":3,"retryDelay":1000},"versionId":"25b51038-e103-4be6-bcd1-64df4b90d4c6","connections":{"OpenAI Chat Model":{"main":[[]]},"Google Calendar - Get Events":{"main":[[]]},"Google Calendar - Create events":{"main":[[]]}},"description":"Automated workflow: AI Agent : Google calendar assistant using OpenAI. This workflow integrates 7 different services: stickyNote, agent, stopAndError, lmChatOpenAi, memoryBufferWindow. It contains 16 nodes and follows best practices for error handling and security.","notes":"Excellent quality workflow: AI Agent : Google calendar assistant using OpenAI. This workflow has been optimized for production use with comprehensive error handling, security, and documentation."}