The CalendarHero connector lets your AI agent act in each user's CalendarHero account. Each user connects their own CalendarHero API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 33 tools.
- Tools
- 33
- What they doRead · write · destructive
- 18 · 11 · 418 read11 write4 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the CalendarHero connection
In AgentKit > Connections, create a CalendarHero connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'calendarhero'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize CalendarHero:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'calendarhero_assistant_reply_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "calendarhero"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize CalendarHero:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="calendarhero_assistant_reply_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their CalendarHero credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcalendarhero_assistant_reply_getGet the CalendarHero assistant's latest reply message for the user.Read-onlyGet Assistant Reply
Get the CalendarHero assistant's latest reply message for the user. Returns the reply text and any options. Use Send Assistant Message first.
Inputs
This tool takes no inputs.
calendarhero_contact_getGet one contact by ID, with insights unless basic is set.Read-onlyGet Contact
Get one contact by ID, with insights unless basic is set. Returns the contact's name, emails, phones, title, organization and insights. Use Search Contacts to find the ID.
Inputs
contact_idstringrequired- CalendarHero contact ID, from Search Contacts. Example: 5f3a1b2c4d5e6f7890123456.
basicboolean- true returns only the data stored in CalendarHero; false (default) also returns contact insights. Example: true.
calendarhero_contacts_countCount the user's contacts.Read-onlyCount Contacts
Count the user's contacts. Returns the number of contacts. Use Search Contacts to list them.
Inputs
This tool takes no inputs.
calendarhero_contacts_searchSearch the user's contacts by email, domain or name, or list popular, recent or by-letter contacts.Read-onlySearch Contacts
Search the user's contacts by email, domain or name, or list popular, recent or by-letter contacts. Returns matching contacts with id, name, emails, title and organization. Use Get Contact for one contact's insights.
Inputs
allstring- 1 to keep duplicate contacts, 0 to remove them (default). Example: 0.one of
10 filterstring- Preset set of contacts instead of a search: popular, recent, or a single letter a to z for names starting with it. Example: recent.one of
popularrecentabcdefghijklmnopqrstuvwxyz include_teamsstring- 1 to also return matching teams. Example: 0.one of
10 searchstring- Email (name@domain.com), domain (@domain.com) or name (First Last) to match. Not used with filter. Example: @acme.com.
calendarhero_directories_listList the calendars, contact books and other services the user has connected to CalendarHero.Read-onlyList Connected Directories
List the calendars, contact books and other services the user has connected to CalendarHero. Returns each connection with its id, provider type, category types and import dates. Use Get Connected Directory for one connection.
Inputs
This tool takes no inputs.
calendarhero_directory_getGet one connected calendar, contact book or other service by its ID.Read-onlyGet Connected Directory
Get one connected calendar, contact book or other service by its ID. Returns its provider type, category types, name and import dates. Use List Connected Directories to find IDs.
Inputs
directory_idstringrequired- Directory (connection) UUID, from List Connected Directories. Example: 6a1f2c3d-4b5e-6f70-8a9b-0c1d2e3f4a5b.
calendarhero_integrations_listList the integration providers CalendarHero supports, optionally by category.Read-onlyList Integrations
List the integration providers CalendarHero supports, optionally by category. Returns each provider with its type and name. Use List Connected Directories for the services the user has connected.
Inputs
orgboolean- Return the organization's integrations instead of the user's. Example: false.
typestring- Only integrations of this category, for example calendar, contacts, video or crm. Example: calendar.one of
calendarcontactsmessagingsocialemailsearchfilesgroupsfaqcrmticketroomsvideoatspayment
calendarhero_meeting_categories_getGet stats on the user's meetings by category for a month.Read-onlyGet Meeting Categories
Get stats on the user's meetings by category for a month. Returns meeting counts and time per category. Use List Meetings for the meetings themselves.
Inputs
monthstring- Month as YYYY-MM. Example: 2026-11.
calendarhero_meeting_requests_listList the meeting requests (scheduling tasks) CalendarHero is handling for the user.Read-onlyList Meeting Requests
List the meeting requests (scheduling tasks) CalendarHero is handling for the user. Returns requests with id, subject, contacts, type, state and proposed times. Use Create Meeting Request to start a new one.
Inputs
skipnumber- Number of requests to skip, for paging. Example: 0.
statestring- Only requests in this state: active, upcoming or closed. Example: active.one of
activeupcomingclosed takenumber- Number of requests to return. Example: 25.
tallyboolean- Return counts instead of the requests. Example: false.
typestring- Only requests of this meeting type. Example: call.
calendarhero_meeting_types_listList the user's meeting types (such as call, coffee or lunch) and their settings.Read-onlyList Meeting Types
List the user's meeting types (such as call, coffee or lunch) and their settings. Returns each meeting type with its name, duration, locations and options. Use a type name in Create Meeting Request.
Inputs
only_typesboolean- Return only the meeting type definitions, without other meeting settings. Example: true.
calendarhero_meetings_listList the user's calendar meetings within a time window.Read-onlyList Meetings
List the user's calendar meetings within a time window. Returns meetings with subject, start and end, attendees and location. Use List Meeting Requests for meetings CalendarHero is still scheduling.
Inputs
endstringrequired- End of the time window (ISO 8601 date-time). Example: 2026-11-23T00:00:00Z.
startstringrequired- Start of the time window (ISO 8601 date-time). Example: 2026-11-16T00:00:00Z.
calendarhero_searchSearch all of the user's connected services (email, files, CRM and others) for a term.Read-onlySearch Integrations
Search all of the user's connected services (email, files, CRM and others) for a term. Returns matching results grouped by service, with result IDs. Use Get Search Result for one result's details.
Inputs
querystringrequired- Term to search for across the user's connected services. Example: Acme proposal.
date_endstring- End of the time window (YYYY-MM-DDTHH:mm:ssZ). Example: 2026-11-16T23:59:59Z.
date_startstring- Start of the time window (YYYY-MM-DDTHH:mm:ssZ). Example: 2026-10-01T00:00:00Z.
calendarhero_search_result_getGet one search result's details.Read-onlyGet Search Result
Get one search result's details. Returns the full result content and source. Use Search Integrations first to get the ID.
Inputs
result_idstringrequired- ID of a result returned by Search Integrations. Example: 6a1f2c3d4b5e6f708a9b0c1d.
calendarhero_user_getGet the CalendarHero user tied to the API token.Read-onlyGet User
Get the CalendarHero user tied to the API token. Returns the user's profile, settings, meeting preferences and connected services. Use it to check the token works and read scheduling settings.
Inputs
This tool takes no inputs.
calendarhero_user_org_getGet the organization the CalendarHero user belongs to.Read-onlyGet Organization
Get the organization the CalendarHero user belongs to. Returns the organization's details and, optionally, billing user info. Use Get User for the user's own profile.
Inputs
return_billing_user_infoboolean- Also return the organization's billing user details. Example: false.
calendarhero_user_savings_getGet the user's CalendarHero time-savings figures.Read-onlyGet Time Savings
Get the user's CalendarHero time-savings figures. Returns how much scheduling time CalendarHero has saved the user. Use Get Meeting Categories for meeting stats by category.
Inputs
This tool takes no inputs.
calendarhero_webhook_sample_getGet a sample payload for a CalendarHero webhook event.Read-onlyGet Webhook Sample
Get a sample payload for a CalendarHero webhook event. Returns an example of the JSON CalendarHero posts for that event. Use it to build a receiver before subscribing.
Inputs
eventstringrequired- Webhook event: meeting_request_success, new_meeting_request, meeting_request_expired, meeting_request_cancelled, meeting_rescheduled, new_contact_added, meeting_completed or meeting_started. Example: new_meeting_request.one of
meeting_request_successnew_meeting_requestmeeting_request_expiredmeeting_request_cancelledmeeting_reschedulednew_contact_addedmeeting_completedmeeting_started
calendarhero_webhooks_listList the webhook URLs subscribed to one CalendarHero event.Read-onlyList Webhooks
List the webhook URLs subscribed to one CalendarHero event. Returns the hook URLs for that event. Use Subscribe Webhook to add one.
Inputs
eventstringrequired- Webhook event: meeting_request_success, new_meeting_request, meeting_request_expired, meeting_request_cancelled, meeting_rescheduled, new_contact_added, meeting_completed or meeting_started. Example: new_meeting_request.one of
meeting_request_successnew_meeting_requestmeeting_request_expiredmeeting_request_cancelledmeeting_reschedulednew_contact_addedmeeting_completedmeeting_started
calendarhero_assistant_message_sendSend a plain-language message to the CalendarHero scheduling assistant, as in the web chat.WriteSend Assistant Message
Send a plain-language message to the CalendarHero scheduling assistant, as in the web chat. Returns the assistant's acknowledgement; it may act on the request. Use Get Assistant Reply to read its reply.
Inputs
textstringrequired- Message to the CalendarHero assistant, in plain language. Example: Schedule a call with jane@acme.com next week.
calendarhero_contact_createCreate a contact in CalendarHero.WriteCreate Contact
Create a contact in CalendarHero. Returns the new contact with its id. Use Search Contacts first to avoid duplicates.
Inputs
emailarrayrequired- The contact's email addresses. Example: ["jane@acme.com"].
default_emailstring- Which of the emails to use by default. Example: jane@acme.com.
namestring- Contact name as "First Last". Example: Jane Doe.
organizationstring- Company or organization. Example: Acme Corp.
telephonearray- Phone numbers. Example: ["+14155550123"].
titlestring- Job title. Example: VP Sales.
calendarhero_contact_updateUpdate a contact's name, emails, phones, title or organization.WriteUpdate Contact
Update a contact's name, emails, phones, title or organization. Returns the updated contact. Send the full email list; email is required.
- Idempotent
Inputs
contact_idstringrequired- CalendarHero contact ID, from Search Contacts. Example: 5f3a1b2c4d5e6f7890123456.
emailarrayrequired- The contact's email addresses. Example: ["jane@acme.com"].
default_emailstring- Which of the emails to use by default. Example: jane@acme.com.
namestring- Contact name as "First Last". Example: Jane Doe.
organizationstring- Company or organization. Example: Acme Corp.
telephonearray- Phone numbers. Example: ["+14155550123"].
titlestring- Job title. Example: VP Sales.
calendarhero_meeting_request_createAsk CalendarHero to schedule a meeting with contacts within a date window.WriteCreate Meeting Request
Ask CalendarHero to schedule a meeting with contacts within a date window. Returns the new meeting request; CalendarHero emails the contacts to find a time. Use List Meeting Requests to follow it. Use Remind Meeting Request to nudge contacts.
Inputs
date_endstringrequired- End of the window to schedule in (YYYY-MM-DDTHH:mm:ssZ). The date part is the last day to consider. Example: 2026-11-21T23:59:59Z.
date_startstringrequired- Start of the window to schedule in (YYYY-MM-DDTHH:mm:ssZ). The date part is the first day to consider. Example: 2026-11-17T00:00:00Z.
subjectstringrequired- Meeting topic or subject. Example: Quarterly review.
capacitynumber- Seats needed in a meeting room. 0 books no room. Example: 0.
contact_emailsarray- Emails of the people to meet. Example: ["jane@acme.com"].
contactsarray- CalendarHero contacts to meet, each as an object with the contact id from Search Contacts. Example: [{"id": "5f3a1b2c4d5e6f7890123456"}].
descriptionstring- Meeting agenda or description. Example: Review Q4 targets..
locationstring- Meeting location. Example: Zoom.
meeting_lengthnumber- Meeting length in minutes. Defaults to the meeting type's duration. Example: 30.
typestring- Meeting type name, from List Meeting Types. Example: call.
calendarhero_meeting_request_remindSend the contacts of a pending meeting request a reminder.WriteRemind Meeting Request
Send the contacts of a pending meeting request a reminder. Returns a confirmation. Sends email to the contacts. Use List Meeting Requests to find the request ID.
Inputs
task_idstringrequired- Meeting request (task) ID, from List Meeting Requests. Example: 60b8d2f4e1a2b3c4d5e6f789.
calendarhero_meeting_type_createAdd a new meeting type with the given name to the user.WriteCreate Meeting Type
Add a new meeting type with the given name to the user. Returns the new meeting type. Use Update Meeting Types to change its settings afterwards.
Inputs
meeting_typestringrequired- Meeting type name, as returned by List Meeting Types (for example call or coffee). Example: call.
calendarhero_meeting_types_updateSave the user's meeting type settings.WriteUpdate Meeting Types
Save the user's meeting type settings. Returns the updated meeting types. Use List Meeting Types first and send back the edited list.
- Idempotent
Inputs
meeting_typesarrayrequired- The full list of meeting type objects to save, in the shape List Meeting Types returns. Fetch them first and send back the edited list. Example: [{"name": "call"}].
calendarhero_user_address_updateSet the geographic location of the user's address, used for travel time and in-person meetings.WriteUpdate Address Location
Set the geographic location of the user's address, used for travel time and in-person meetings. Returns the updated settings. Use Get User to read the current settings.
- Idempotent
Inputs
latstringrequired- Latitude of the user's address. Example: 37.7749.
lngstringrequired- Longitude of the user's address. Example: -122.4194.
calendarhero_user_restricted_apps_updateSet which connected apps CalendarHero must not use for the user.WriteUpdate Restricted Apps
Set which connected apps CalendarHero must not use for the user. Returns the updated settings. Use List Integrations to see app names.
- Idempotent
Inputs
restricted_appsarrayrequired- Names of the integrations or apps CalendarHero must not use for this user. Example: ["slack"].
calendarhero_webhook_subscribeSubscribe a URL to a CalendarHero event, such as a new meeting request or a completed meeting.WriteSubscribe Webhook
Subscribe a URL to a CalendarHero event, such as a new meeting request or a completed meeting. Returns the subscription. Use Get Webhook Sample to see the payload.
Inputs
eventstringrequired- Webhook event: meeting_request_success, new_meeting_request, meeting_request_expired, meeting_request_cancelled, meeting_rescheduled, new_contact_added, meeting_completed or meeting_started. Example: new_meeting_request.one of
meeting_request_successnew_meeting_requestmeeting_request_expiredmeeting_request_cancelledmeeting_reschedulednew_contact_addedmeeting_completedmeeting_started hook_urlstringrequired- HTTPS URL that receives the webhook POSTs. Example: https://example.com/hooks/calendarhero.
calendarhero_contact_deleteDelete a contact from CalendarHero.DestructiveDelete Contact
Delete a contact from CalendarHero. Returns a confirmation. Use Search Contacts to find the ID.
- Idempotent
Inputs
contact_idstringrequired- CalendarHero contact ID, from Search Contacts. Example: 5f3a1b2c4d5e6f7890123456.
calendarhero_meeting_request_deleteDelete (cancel) a meeting request.DestructiveDelete Meeting Request
Delete (cancel) a meeting request. Returns a confirmation. Use List Meeting Requests to find the request ID.
- Idempotent
Inputs
task_idstringrequired- Meeting request (task) ID, from List Meeting Requests. Example: 60b8d2f4e1a2b3c4d5e6f789.
calendarhero_meeting_type_deleteDelete one of the user's meeting types by name.DestructiveDelete Meeting Type
Delete one of the user's meeting types by name. Returns the remaining meeting types. Use List Meeting Types to find the name.
- Idempotent
Inputs
meeting_typestringrequired- Meeting type name, as returned by List Meeting Types (for example call or coffee). Example: call.
calendarhero_webhook_unsubscribeRemove a URL's subscription to a CalendarHero event.DestructiveUnsubscribe Webhook
Remove a URL's subscription to a CalendarHero event. Returns a confirmation. Use List Webhooks to see subscribed URLs.
- Idempotent
Inputs
eventstringrequired- Webhook event: meeting_request_success, new_meeting_request, meeting_request_expired, meeting_request_cancelled, meeting_rescheduled, new_contact_added, meeting_completed or meeting_started. Example: new_meeting_request.one of
meeting_request_successnew_meeting_requestmeeting_request_expiredmeeting_request_cancelledmeeting_reschedulednew_contact_addedmeeting_completedmeeting_started hook_urlstringrequired- HTTPS URL that receives the webhook POSTs. Example: https://example.com/hooks/calendarhero.
No tools match.