Skip to content

Connect Hermes Agent to Cal.com

Connect Hermes Agent to Cal.com: 1. Sign in to ApexGenius and connect Cal.com. 2. Add the ApexGenius MCP server. 3. Start using Cal.com in Hermes Agent.

1,000 free credits · No card required

How to connect Cal.com to Hermes Agent

  1. 1Sign in to ApexGenius and connect Cal.com
  2. 2Add the ApexGenius MCP server to Hermes Agent
  3. 3Start using Cal.com in Hermes Agent
  1. 1Cal.com

    Connect Cal.com to ApexGenius

    Connect Cal.com

    Create an API key in Cal.com. You paste it into ApexGenius once.

  2. 2ApexGenius

    Connect ApexGenius to Hermes Agent

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  3. 3ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius MCP server to Hermes Agent

Hermes Agent reads MCP servers from ~/.hermes/config.yaml, under mcp_servers.

  1. Add the apexgenius entry under mcp_servers and save the file.
  2. In a new terminal, run hermes mcp login apexgenius. Hermes prints an authorize URL and opens your browser when it can.
  3. Sign in to ApexGenius and approve access.
  4. Start Hermes with hermes chat, or run /reload-mcp in a session that is already open.
Add to ~/.hermes/config.yaml
mcp_servers:
  apexgenius:
    url: "https://server.autom8.pro/mcp"
    auth: oauth

Check it. Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes.

Steps follow Hermes Agent documentation, MCP (Model Context Protocol) (opens in a new tab), read November 12, 2026.

Then ask Hermes Agent

List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.

Start free
Written setup, step by stepShow

Before you start

  • A Cal.com account.
  • An API key from Cal.com Settings > Developer > API keys.

1. Connect Cal.com to ApexGenius

  1. Create an API key in Cal.com. In Cal.com open Settings, then Developer, then API keys, and choose New. Name the key, turn on Never expires, and choose Create. Copy the key once. Without Never expires it stops working after 30 days.
    The full Cal.com settings page on Developer, API keys, with the account name blurred and red boxes marking the API keys menu item and the New button.
    Settings, then Developer, then API keys. New, marked in red, starts a key for your own account. The account name is blurred in this capture.Open full-size image (opens in a new tab)
    The full Cal.com Create an API key dialog with red boxes marking the Never expires switch and the Create button, and the account name blurred.
    Name the key, turn on Never expires, and choose Create. A key left on the 30-day default stops working after a month.Open full-size image (opens in a new tab)
  2. Open Cal.com in Connections. Choose Connect or Add connection.
  3. Enter the API key. Paste the key from Cal.com. ApexGenius supplies the API address and checks the key against your Cal.com profile.
  4. Check the saved connection. Save after validation succeeds. Review the Tools tab. Booking, rescheduling and cancelling email the attendees.
Connect Cal.com →

2. Connect ApexGenius to Hermes Agent

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The steps are above, under Add the ApexGenius MCP server to Hermes Agent. These notes apply to Hermes Agent only.

  • On a server with no browser. Hermes prints “Or paste the redirect URL here” beside the authorize URL. Open the URL on your own machine, approve, and paste the full URL the browser lands on. That page shows a connection error, which is expected.
  • Use a new terminal for the sign-in. Editing config.yaml inside a running session reloads MCP with a 30 second limit, too short for a browser sign-in. hermes mcp login waits five minutes.
  • Where the sign-in is kept. Hermes caches the tokens at ~/.hermes/mcp-tokens/apexgenius.json and reuses them until a refresh fails. Run hermes mcp login apexgenius again if that happens.
  • Tool names. Hermes prefixes each MCP tool with the server name, so the ApexGenius tools carry apexgenius in their names.
  • Access. When ApexGenius asks what Hermes Agent may use, choose Read only for the first test, or Custom to limit it to the tools you need.

3. Verify one safe read

List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.

List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.

Compare the bookings with your Cal.com Upcoming list. Reading bookings sends no emails.

Full guide: the Cal.com setup guide.

What it looks like in Hermes Agent

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Hermes Agent
Hermes AgentApexGenius MCP route
List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.
ApexGenius
Working with ApexGenius3 reads
RequestConnected read
Account scopeAuthorized connections checked
Salesforceapex_call_read_toolsalesforce_read · Find matching recordsComplete
Salesforceapex_call_read_toolsalesforce_read · Read related activityComplete
n8napex_call_read_tooln8n_get_workflow · Check workflow statusComplete
Hermes Agent

Three safe example reads returned results. Nothing was changed.

Read-only route
Hermes Agent

Try asking

List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.

Show my Cal.com event types and their available time slots. Do not create a booking.

What Hermes Agent can do in Cal.com

3 operations: 2 read, 1 write. Read looks things up and changes nothing. Writes change Cal.com and run only when you turn them on.

Cal.com tools

2 read · 1 write
  • cal_com_search_operationsread
  • cal_com_read_operationread
  • cal_com_write_operationwrite

You choose the access. When you approve Hermes Agent, pick Full access, Read only, or Custom.

The API key covers its Cal.com account. Requests use the fixed Cal.com API address.

The read route refuses booking changes. Enabled writes run when called.

Booking, rescheduling and cancelling email attendees. Cancelling a meeting cannot restore the original booking.

Start free

Questions about connecting Hermes Agent to Cal.com

Updated November 12, 2026.

How do I connect Hermes Agent to Cal.com?

Sign in to ApexGenius and connect Cal.com. In Hermes Agent, add an apexgenius entry with the ApexGenius MCP address and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login apexgenius. Then ask Hermes Agent: “List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.” Start with a read, so nothing changes.

How do I check that Hermes Agent can use Cal.com?

Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes. In a session that is already open, /reload-mcp picks up a config change. If the sign-in has expired, run hermes mcp login apexgenius again. Then ask: “List my upcoming Cal.com bookings for this week. Do not book, move or cancel anything.”

What do I need to connect Cal.com?

A Cal.com account and an API key from Settings, Developer, API keys. ApexGenius checks it against your profile before saving.

Can my AI send booking emails?

Booking, rescheduling and cancelling through an enabled write tool email attendees. Start with reads and enable booking tools only when needed.

Does this use Cal.com hosted MCP?

ApexGenius uses the official Cal.com API v2 with your API key.

What should I test first?

Ask for your upcoming bookings and compare them with Cal.com. Reading bookings sends no emails.

Connect Cal.com to Hermes Agent today

Start free

1,000 free credits. No card required. Disconnect any time.