otherapi_key

CalendarHero

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.

Verdict

CalendarHero lets your team schedule meetings, manage contacts, and pull calendar data without leaving Switchy. @mention it to create meeting requests with availability windows, fetch upcoming events across connected calendars, or add new contacts before sending invites. It's most useful for teams coordinating client calls or cross-timezone standups — you can template common meeting types and reuse them. Setup requires an API key from CalendarHero's dashboard, and you'll need to connect your calendar provider (Google, Outlook) through their interface first before the MCP can read your availability.

Common use cases

  • Schedule client calls with availability windows
  • Pull next week's meetings into standup notes
  • Create contacts before sending calendar invites
  • List meeting templates for recurring check-ins
  • Fetch calendar details for trip planning

Integration

Vendor
CalendarHero
Category
other
Auth
API_KEY
Tools
13
Composio slug
calendarhero

Tools

  • Add Calendar Connection

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

  • Create Contact

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

  • Create Meeting Request V2

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

  • Fetch Contact

    Fetch contact

  • Fetch Meeting Details

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

  • Fetch User Profile

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

  • List Meetings

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

  • List Meeting Templates

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

  • List Meeting Types

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

  • List User Calendars

    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.

  • Search Contact

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

  • Send Reminder

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

  • Update Contact

    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.'

Setup

Setup guide

  1. 11. Go to your CalendarHero account settings and generate an API key under Integrations or Developer Access. 2. In Switchy, open Settings > Integrations > Add MCP Server and select CalendarHero. 3. Paste your API key when prompted and click Connect. 4. CalendarHero will confirm the connection by fetching your user profile — you'll see your name and connected calendars listed. 5. If you haven't already, add your Google or Outlook calendar inside CalendarHero's own dashboard so the MCP can read availability. 6. Open any Space in Switchy and type '@CalendarHero fetch my meetings for next week' to test — it should return your calendar events. 7. To schedule a meeting, use '@CalendarHero create a meeting request' and provide participant emails, a time range, and duration.

What teammates see: by default, memories from CalendarHero are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Schedule Team Sync

@CalendarHero create a meeting request for a 30-minute team sync next Tuesday between 9am-5pm EST with alex@example.com and jordan@example.com. Title it 'Q1 Planning Kickoff'.
Open in a Space →

Fetch This Week's Meetings

@CalendarHero list my meetings from today through Friday. Include titles, times, and participant emails.
Open in a Space →

Add New Contact

@CalendarHero create a contact for Sam Chen, email sam.chen@clientco.com, phone +1-555-0199, company ClientCo.
Open in a Space →

Show Meeting Templates

@CalendarHero list all my meeting templates. Show the title, duration, and any default settings for each.
Open in a Space →

Get Meeting Details

@CalendarHero fetch details for meetings on March 15th. Include location, participant list, and any notes or attachments.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@CalendarHero list all my meetings for next week and summarize which ones are internal vs. external

Output

I found 14 meetings scheduled for next week (Jan 13-19). Internal meetings (8 total): Monday's sprint planning, Tuesday's 1:1s with Sarah and Marcus, Wednesday's design review, Thursday's all-hands and product sync, Friday's retro and demo. External meetings (6 total): client check-ins with Acme Corp (Tuesday), vendor onboarding with DataCo (Wednesday), two prospect calls (Thursday), and partner strategy session with TechPartners (Friday). Your heaviest day is Thursday with 5 back-to-back meetings from 9am-3pm.

Notes

This example combines CalendarHero's List Meetings tool with AI synthesis to categorize and surface patterns. Requires read access to calendar data. The MCP returns raw meeting objects; the AI interprets participant domains and meeting titles to infer internal vs. external classification—accuracy depends on consistent naming conventions in your calendar.

Prompt

@CalendarHero create a meeting request for 'Q1 Planning' with the product team, 90 minutes sometime next Tuesday or Wednesday afternoon

Output

I've created a meeting request in CalendarHero for 'Q1 Planning' with a 90-minute duration. The request offers three time slots: Tuesday 1:00-2:30pm, Tuesday 3:00-4:30pm, and Wednesday 2:00-3:30pm. Invitations have been sent to the 4 product team members in your contacts. Recipients can select their preferred slot via the CalendarHero booking page, and the meeting will auto-confirm once everyone responds. You'll receive a notification when consensus is reached.

Notes

Demonstrates the Create Meeting Request V2 tool, which handles availability polling across multiple participants. This workflow requires that team members exist as contacts in your CalendarHero account and have connected calendars. The MCP doesn't directly book the meeting—it creates a request that participants vote on, avoiding the back-and-forth of manual scheduling.

Prompt

@CalendarHero show me my meeting templates and draft a new 'Customer Onboarding' template based on the structure of my existing 'Sales Demo' template

Output

You have 5 meeting templates configured: Sales Demo (45min), Technical Deep Dive (60min), Quick Sync (15min), Interview - Engineering (90min), and Board Update (120min). Based on your Sales Demo template, here's a draft Customer Onboarding template: 60-minute duration (vs. 45min for sales), buffer time of 15min before/after, video conferencing enabled via your default Zoom link, and pre-meeting questions asking for company size, primary use case, and technical point of contact. The Sales Demo includes a product walkthrough section—I've adapted this to 'platform setup walkthrough' for onboarding context.

Notes

Uses List Meeting Templates to retrieve existing configurations, then applies AI reasoning to propose a new template structure. The MCP provides read access to templates but doesn't create new ones via this tool set—you'd need to manually configure the suggested template in CalendarHero's UI. Useful for auditing your scheduling workflows and identifying gaps in your template library.

Use-case deep-dives

Outbound sales team scheduling

When CalendarHero beats manual back-and-forth for AE teams

A 6-person sales team closing 20-30 demos a week spends half their Slack time coordinating calendars with prospects. CalendarHero's meeting request tool lets AEs send availability blocks without leaving their CRM context—Switchy surfaces the MCP right when someone pastes a LinkedIn profile or mentions "demo." The contact creation tool pre-fills from prior conversations, and meeting templates standardize discovery vs. technical calls. This works until your team hits 50+ meetings a week or needs complex round-robin logic; at that scale, CalendarHero's 13-tool surface area becomes limiting and you're better off with a dedicated scheduling platform. For teams under 10 reps doing mostly 1:1 outbound, the MCP keeps scheduling in the same workspace as deal notes.

Fractional consultant availability sync

How solo consultants use CalendarHero for multi-client juggling

A fractional CFO working with four startups needs each client to see different availability windows without manually blocking time across three calendar apps. CalendarHero's calendar connection tool pulls Google, Outlook, and iCloud into one view, then the meeting templates tool creates client-specific booking links ("Acme 30-min check-ins" vs. "Beta Corp month-end reviews"). Switchy's shared context means the consultant's EA can see which templates are booked heaviest and suggest schedule adjustments in the same thread as invoice reminders. The fetch meeting details tool becomes the single source for "what's this week look like?" queries. This breaks down if you need more than 8-10 templates or complex conditional logic; CalendarHero doesn't do "only show Tuesdays after 2pm if I'm in Seattle." For straightforward multi-calendar aggregation at 1-2 person scale, it's faster than Calendly's UI.

Customer success check-in cadence

When CalendarHero's contact fetch beats CRM calendar sync

A 3-person CS team managing 40 accounts runs monthly check-ins but their CRM's calendar sync is a 48-hour lag mess. CalendarHero's fetch contact and list meetings tools let the team pull real-time availability and past meeting history without leaving Switchy—someone asks "when did we last talk to Acme?" and the MCP answers in 2 seconds. The create meeting request tool books follow-ups while the context is fresh, and meeting templates enforce the 25-minute vs. 50-minute cadence the team agreed on. This only works if your contact list is under 200 and you're not doing complex segmentation; CalendarHero doesn't have tagging or bulk operations. For small CS teams tired of CRM calendar plugins that break every update, the MCP is a cleaner pipe.

Frequently asked

What does the CalendarHero MCP do in Switchy?

It connects your CalendarHero account so AI agents can schedule meetings, create contacts, and pull calendar data without leaving the conversation. The MCP exposes 13 tools covering meeting requests, template management, and calendar integrations. Your team can automate scheduling workflows that normally require switching between CalendarHero's UI and other apps.

Do I need a CalendarHero API key to connect this MCP?

Yes. This MCP uses API key authentication, not OAuth. You'll need to generate an API key from your CalendarHero account settings and paste it into Switchy during setup. Anyone with the key can access your CalendarHero data, so treat it like a password and only share it with team members who need it.

Can the MCP automatically accept meeting invites or modify existing events?

No. The MCP creates new meeting requests and fetches existing meeting details, but it doesn't accept invites or edit events already on your calendar. If you need to change a meeting, you'll still use CalendarHero's UI or the underlying calendar provider directly. The MCP is for scheduling new meetings and pulling data, not managing responses.

How is this different from just using CalendarHero's web app?

The MCP lets AI agents schedule meetings and check availability inside Switchy conversations without manual copy-paste. If your team already uses CalendarHero's UI for one-off scheduling, you won't see much benefit. But if you're automating workflows—like an agent that books calls after qualifying leads—the MCP removes the human handoff.

Who on my team should connect the CalendarHero MCP?

Whoever owns the CalendarHero account and has an API key. If multiple people schedule meetings, each needs their own API key and separate MCP connection in Switchy. The MCP doesn't share calendar access across team members—it's tied to one CalendarHero account per connection.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.