Calendarhero | Composio Docs

Overview

SLUG: CALENDARHERO

Description

CalendarHero is a versatile scheduling tool designed to streamline and simplify your calendar management. It integrates seamlessly with your existing calendars, allowing you to efficiently schedule, reschedule, and manage meetings with ease.

Authentication Details

API Key

bearer_token

stringRequired

Connecting to Calendarhero

Create an auth config

Use the dashboard to create an auth config for the Calendarhero toolkit. This allows you to connect multiple Calendarhero accounts to Composio for agents to use.

Select App

Navigate to the Calendarhero toolkit page and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 from composio.types import auth_scheme
3 
4 # Replace these with your actual values
5 calendarhero_auth_config_id = "ac_YOUR_CALENDARHERO_CONFIG_ID" # Auth config ID created above
6 user_id = "0000-0000-0000"  # UUID from database/app
7 
8 composio = Composio()
9 
10 def authenticate_toolkit(user_id: str, auth_config_id: str):
11     # Replace this with a method to retrieve an API key from the user.
12     # Or supply your own.
13     user_api_key = input("[!] Enter API key")
14 
15     connection_request = composio.connected_accounts.initiate(
16         user_id=user_id,
17         auth_config_id=auth_config_id,
18         config={"auth_scheme": "API_KEY", "val": user_api_key}
19     )
20 
21     # API Key authentication is immediate - no redirect needed
22     print(f"Successfully connected Calendarhero for user {user_id}")
23     print(f"Connection status: {connection_request.status}")
24     
25     return connection_request.id
26 
27 
28 connection_id = authenticate_toolkit(user_id, calendarhero_auth_config_id)
29 
30 # You can verify the connection using:
31 connected_account = composio.connected_accounts.get(connection_id)
32 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Calendarhero toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["CALENDARHERO"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

CALENDARHERO_ADD_CALENDAR_CONNECTION

Tool Name: Add Calendar Connection

Description

Tool to add a calendar integration to a user's account. use after gathering provider credentials.

Action Parameters

CALENDARHERO_CREATE_CONTACT

Tool Name: Create Contact

Description

Tool to create a new contact. use after confirming contact details before making the api call.

Action Parameters

defaultEmail

string

arrayRequired

name

string

organization

string

telephone

array

title

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_CREATE_MEETING_REQUEST_V2

Tool Name: Create Meeting Request V2

Description

Tool to create a new meeting request in calendarhero. use when scheduling a meeting with participants, time range, and additional details.

Action Parameters

capacity

integer

contactEmails

array

contacts

array

dateEnd

stringRequired

dateStart

stringRequired

description

string

location

string

locations

array

meetingLength

integer

room

object

roomCapacity

integer

subject

stringRequired

type

string

Action Response

data

stringRequired

error

string

successful

booleanRequired

CALENDARHERO_FETCH_CONTACT

Tool Name: Fetch Contact

Description

Fetch contact

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_FETCH_MEETING_DETAILS

Tool Name: Fetch Meeting Details

Description

Tool to fetch details for meetings within a specified timeframe. use this after user provides start and end datetimes in iso8601.

Action Parameters

end

stringRequired

start

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_FETCH_USER_PROFILE

Tool Name: Fetch User Profile

Description

Tool to fetch the profile details of the authenticated user. use after obtaining a valid access token.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_LIST_MEETINGS

Tool Name: List Meetings

Description

Tool to retrieve the user's meetings within a specified timeframe. use after confirming date range to fetch raw calendar data.

Action Parameters

end

stringRequired

start

stringRequired

Action Response

data

stringRequired

error

string

successful

booleanRequired

CALENDARHERO_LIST_MEETING_TEMPLATES

Tool Name: List Meeting Templates

Description

Tool to list all meeting templates available for quick scheduling. use after authenticating and when you need to retrieve available templates before scheduling.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_LIST_MEETING_TYPES

Tool Name: List Meeting Types

Description

Tool to retrieve the user's configured meeting types. use after authenticating with calendarhero.

Action Parameters

onlyTypes

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_LIST_USER_CALENDARS

Tool Name: List User Calendars

Description

Tool to list all calendar integrations connected to a user's calendarhero account. use after authenticating when you need to retrieve available calendars for scheduling.

Action Parameters

org

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_SEARCH_CONTACT

Tool Name: Search Contact

Description

Tool to search for existing contacts. use after confirming a need to find contacts by email or name.

Action Parameters

all

boolean

filter

string

includeTeams

boolean

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_SEND_REMINDER

Tool Name: Send Reminder

Description

Tool to send a reminder to a contact about their scheduled meeting. use after confirming the meeting task id to notify participants.

Action Parameters

Required

Action Response

data

objectRequired

error

string

successful

booleanRequired

CALENDARHERO_UPDATE_CONTACT

Tool Name: Update Contact

Description

Tool to update details of an existing contact. use when you have the contact's id and want to apply changes. example: 'update contact 507f1f77bcf86cd799439011 with a new email.'

Action Parameters

defaultEmail

string

arrayRequired

stringRequired

name

string

organization

string

providerId

array

telephone

array

title

string

userId

string

Action Response

data

objectRequired

error

string

successful

booleanRequired