AI assistant (Claude, ChatGPT, Codex)
Connect Claude, ChatGPT or Codex to your calendar and ask for free time, your week, new activities, meetings and tasks in plain words.
You can connect an AI assistant to herbe.calendar and ask it things instead of clicking: "when am I free tomorrow?", "create a Teams meeting with Anna on Friday". It works as you, with the same rights you have on screen. You set it up once.
You need three things first: you sign in to herbe.calendar with herbe ID, you have signed in at least once, and your admin has switched AI tools on for you. If connecting fails, ask your admin.
The address to give your assistant is the same for all of them:
https://id.herbe.app/mcp
Connect from Claude
- In Claude open Settings → Connectors → Add custom connector.
- Give it a name (for example "herbe") and paste the address above.
- Click Connect. You are taken to herbe ID: sign in, then press Allow once.
On the Claude phone app the connector you added on the web is there too, so you can ask by voice.
Connect from ChatGPT
Add a custom connector (or app) with the same address. The menu names differ by plan and change from time to time; look under Settings for Connectors, Apps or developer mode, and choose to add your own server. Sign in with herbe ID and press Allow.
Connect from Codex
Codex is the command-line tool. Add the server to ~/.codex/config.toml:
[mcp_servers.herbe]
url = "https://id.herbe.app/mcp"
Then sign in:
codex mcp login herbe
A browser window opens for herbe ID. Sign in and press Allow. (herbe is just the name you chose in the config; use the same name in the command.)
What to ask
- "When am I free tomorrow afternoon?" and "When are Anna and I both free on Thursday for an hour?"
- "What do I have this week?"
- "Create an activity for customer Acme tomorrow 10 to 11, type Meeting." (the assistant picks the ERP company, or asks)
- "Set up a Teams meeting with Anna on Friday at 14:00 using my Client call template."
- "Move it to 14:00." / "Add a comment: sent the offer."
- "Delete my 14:00 meeting tomorrow." (it shows you what would be deleted and waits for your yes)
- "Mark my task 'Send report' as done."
- "When is my sales team (favorite) free next week for 45 minutes?"
- "Send me the link to my booking page." / "Who booked through my links this week?"
- "Book Anna Ozola from Acme (anna@acme.com) for Thursday at 10:00 through my intro call link." (see Booking a customer through your link)
It asks back
If it does not have what the calendar needs, it asks you instead of guessing: a customer or project for an ERP activity whose type requires one, the end time of a meeting, which Anna you mean. Answer in a sentence and it carries on. Nothing is created until it has everything.
Check every change
Every item it creates or changes comes back with a link that opens it in herbe.calendar. Open it and look. Some things it cannot do (for example cancel a booking, or delete a task): do those on screen. It also tells you when something is refused, for example an approved activity, an Outlook event someone else organises, or an ERP company in a maintenance window (it does not try the ERP then). If the ERP does not answer when it creates an activity, the event may still have been saved: the assistant looks for it before creating it again, and you can check the day on screen too.
When it needs your approval
Some things are never done just because the assistant says so. It gives you a link instead, and nothing happens until you open that link in herbe.calendar (signed in as yourself, in your browser) and press Approve:
- an invitation to someone outside your organisation: any guest address that is not a member of this calendar account (a colleague whose address in the people list is an outside one counts too). This includes the notes of the event, because the guests get them;
- a change to an Outlook or Google event that has someone outside your organisation on it, or that adds one (they get the update);
- accepting or declining an invitation from someone outside your organisation;
- booking a customer through your booking link, when the customer's address is not a member of your calendar account, because they get a confirmation e-mail;
- deleting an event, always, because it cannot be undone.
The page shows everything: each guest address, the title, the time, the notes, the location (for a booking: the link and template, the time, the customer's address and their answers). Read it and press Approve or Reject. The link works once and for 15 minutes; after that, ask the assistant again. If the page cannot show the whole action there is no Approve button. Inviting colleagues, and everything the assistant does that stays inside your organisation, works without it.
Only you can approve it: a link that reaches someone else, or that you open signed in as another person, does nothing. Ask the assistant "did it go through?" and it can tell you how the request ended.
Booking a customer through your link
You agreed a time with a customer on the phone? Ask the assistant to book it through your own booking link, for example "Book anna@acme.com for Thursday at 10:00 through my intro call link". The link's template then does what it does when a customer books on your page: it makes the ERP activity, the Outlook or Google event and the Zoom meeting, and the customer gets the confirmation e-mail with a cancel link. The assistant first looks at the free times of the link (it can show you them: "which times does my intro call link offer next week?") and books exactly one of those.
- Only times the link offers. If the time you agreed is not one of the link's free slots (it is taken, outside your hours, too soon, on a holiday), the assistant says so and books nothing. To put a meeting at another time, ask it to create an event from a template instead.
- It asks for what the page asks. If your booking page asks the customer for something required (a company, a phone number), the assistant asks you for it and never makes it up.
- You approve it. The customer gets an e-mail, and so does everyone who is on your link, so unless all of those addresses are members of your calendar account you get an approval link first (see above). It shows the link and template by name, the time, the customer's address, their answers and everyone who is told. Nothing is booked until you press Approve; if the slot is taken meanwhile, or you changed the link or its template settings, nothing is booked and you are told. If something did not go as planned after you approved (the confirmation e-mail could not be sent, one of the template's targets failed) the page says so under the result.
- It works only with your own links. The booking shows up under "Who booked through my links?" like any other. The cancel link goes to the customer in their e-mail; to cancel a booking, use the screen.
Deleting an event
The assistant can delete an event you organise in Outlook or Google, or any event on a Google calendar you connected (the page says who organises it and that it disappears for everyone on that calendar), an ERP activity you are on that is not approved or locked, and a repeating event: one occurrence, or the whole series. The approval page tells you which event it means (title, day, time, calendar, and whether guests or colleagues watching it will be notified); nothing is deleted until you press Approve. When it would be the whole series the page says so plainly ("every occurrence"). An invitation from someone else is declined instead of deleted.
What the AI sees
The AI company you chose receives the calendar data it reads to answer you: titles, times, names, comments. E-mail addresses, phone numbers and personal ID codes are removed first. Do not connect if your company does not allow it.
Disconnect
Open herbe ID, My account → Connected apps, and click Disconnect next to the assistant (listed as, for example, "Claude (AI)"). Access ends at once. You can connect again at any time.
Good to know
- The old email login still works as before; connecting an assistant changes nothing about it.
- If you are in two organisations, tell the assistant which one you mean.
- Your connection lasts about three months; if you do not use it for two weeks, you may have to sign in again. Then you press Allow again.