Google Calendar Tool

The Google Calendar Tools allow your agent to create and view Google Calendar events from a linked calendar.

Setup

To use the Google Calendar Tools you need to install the following official peer dependency:

• npm
• Yarn
• pnpm

npm install googleapis

Usage

tip

See this section for general instructions on installing integration packages.

• npm
• Yarn
• pnpm

npm install @langchain/openai @langchain/core @langchain/community @langchain/langgraph

import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { ChatOpenAI } from "@langchain/openai";
import { Calculator } from "@langchain/community/tools/calculator";
import {
  GoogleCalendarCreateTool,
  GoogleCalendarViewTool,
} from "@langchain/community/tools/google_calendar";

export async function run() {
  const model = new ChatOpenAI({
    temperature: 0,
    apiKey: process.env.OPENAI_API_KEY,
    model: "gpt-4o-mini",
  });

  const googleCalendarParams = {
    credentials: {
      clientEmail: process.env.GOOGLE_CALENDAR_CLIENT_EMAIL,
      privateKey: process.env.GOOGLE_CALENDAR_PRIVATE_KEY,
      calendarId: process.env.GOOGLE_CALENDAR_CALENDAR_ID,
    },
    scopes: [
      "https://www.googleapis.com/auth/calendar",
      "https://www.googleapis.com/auth/calendar.events",
    ],
    model,
  };

  const tools = [
    new Calculator(),
    new GoogleCalendarCreateTool(googleCalendarParams),
    new GoogleCalendarViewTool(googleCalendarParams),
  ];

  const calendarAgent = createReactAgent({
    llm: model,
    tools,
  });

  const createInput = `Create a meeting with John Doe next Friday at 4pm - adding to the agenda of it the result of 99 + 99`;

  const createResult = await calendarAgent.invoke({
    messages: [{ role: "user", content: createInput }],
  });
  //   Create Result {
  //     output: 'A meeting with John Doe on 29th September at 4pm has been created and the result of 99 + 99 has been added to the agenda.'
  //   }
  console.log("Create Result", createResult);

  const viewInput = `What meetings do I have this week?`;

  const viewResult = await calendarAgent.invoke({
    messages: [{ role: "user", content: viewInput }],
  });
  //   View Result {
  //     output: "You have no meetings this week between 8am and 8pm."
  //   }
  console.log("View Result", viewResult);
}

API Reference:

• createReactAgent from @langchain/langgraph/prebuilt
• ChatOpenAI from @langchain/openai
• Calculator from @langchain/community/tools/calculator
• GoogleCalendarCreateTool from @langchain/community/tools/google_calendar
• GoogleCalendarViewTool from @langchain/community/tools/google_calendar

Related

• Tool conceptual guide
• Tool how-to guides