Connect Claude or ChatGPT

Add the Agenda Hero MCP connector to Claude or ChatGPT so the assistant can read your calendars and add, change, and remove events.

The Agenda Hero connector gives an AI assistant access to your pages and planners. Once it is connected, the assistant can look up your events and add, change, and remove them when you ask. It works with Claude, Claude Code, and ChatGPT.

The connector is an MCP (Model Context Protocol) server. ChatGPT lists it in its plugin directory. Claude and Claude Code connect to its server URL:

https://agendahero.com/api/mcp

Connect Claude

These steps are for Claude on the web and Claude Desktop. A connector added there is also available in the Claude apps for iOS and Android.

Open Customize, then Connectors.
Click +, then Add custom connector.
Enter a name, such as Agenda Hero, and the server URL, https://agendahero.com/api/mcp. Agenda Hero needs nothing under Advanced settings. Click Add.
Find the new connector in the list and click Connect.
Sign in to Agenda Hero and choose Allow access. See Signing in and approving.

Custom connectors are available on every Claude plan. A Free account can add one custom connector.

To turn the connector on or off for a conversation, click + in the message box and open Connectors.

Claude Team and Enterprise

An Owner or Primary Owner adds the connector for the organization first. In Organization settings, open Connectors, click Add, choose Custom, then Web, and enter the server URL. Each member then opens Customize, then Connectors, and clicks Connect on Agenda Hero.

Claude's help center has the current steps for each plan.

Connect Claude Code

Run this in a terminal:

claude mcp add --transport http agendahero https://agendahero.com/api/mcp

Then start Claude Code, run /mcp, and choose agendahero. Sign in and approve in the browser window that opens.

That command adds the connector to the current project. To add it for every project, include --scope user:

claude mcp add --transport http --scope user agendahero https://agendahero.com/api/mcp

Connect ChatGPT

Agenda Hero is listed in ChatGPT's plugin directory. There is no server URL to enter.

Open Agenda Hero in ChatGPT, or select Plugins in the ChatGPT sidebar and search for Agenda Hero.
Select Install plugin. If ChatGPT asks, select Connect.
Sign in to Agenda Hero and choose Allow access. See Signing in and approving.

ChatGPT uses Agenda Hero when a request calls for it. To choose it yourself, type @ and pick Agenda Hero, or select + and enter its name.

Which plugins you can install depends on your ChatGPT plan, region, and workspace. In a Business, Enterprise, or Edu workspace, Agenda Hero may show Disabled by admin until an admin enables it: in the Admin console, they select the workspace and open Plugins.

If you added Agenda Hero in developer mode before it was listed, you can delete that app and connect from the plugin directory instead.

OpenAI's help center has the current steps.

Signing in and approving

Each assistant opens Agenda Hero in your browser to approve the connection.

Sign in to Agenda Hero, if you are not signed in already.
Check the consent screen. It names the assistant and shows the email address of the Agenda Hero account being connected.
Choose Allow access. The browser returns to the assistant.

Cancel returns to the assistant without connecting.

The consent screen lists what the assistant will be able to do:

Permission	On the consent screen
`calendars:read`	See the names and details of your calendars
`events:read`	Read the events on your pages and planners
`events:write`	Add, change, and remove events on your pages and planners

ChatGPT also asks for two permissions that tell it which account is connected:

Permission	On the consent screen
`openid`	Know which Agenda Hero account you signed in with
`email`	See your email address

To connect a different Agenda Hero account, sign out of Agenda Hero, then start the connection again from the assistant.

If the screen says This request has expired, start the connection again from the assistant.

What the assistant can do

List your calendars: every page and planner you can open, across every workspace you belong to.
Give you a calendar's link: its public link if the calendar is published, and the link that opens it in Agenda Hero.
Read events on a calendar, for all dates or for a date range, including each event's category, who, and labels.
Add events, one at a time or several in one request.
Change an event: its title, emoji, description, location, date and time, time zone, or repeat pattern.
Set an event's category, who, and labels.
Remove an event.

The assistant has the same access you do. It can read any calendar you can open. It can add, change, and remove events, and set their category, who, and labels, only on calendars you can edit.

Heads up

Agenda Hero saves each change as soon as the assistant makes it. There is no review step in Agenda Hero, and a removed event cannot be restored.

Times and time zones

Times are read in the calendar's own time zone unless you name another one.

Repeating events

The assistant can make an event repeat daily, weekly, every other week, monthly, or yearly, optionally until a date you give. A change or removal applies to the whole series. The assistant cannot change or remove a single occurrence.

Locations

A location links to Google Maps only when it has the place's Google place ID. The assistant is told to send a place ID only when it got one from a lookup such as Google Maps. A location it sets or changes without one is saved as text, with no map link. To add the link, open the event and choose the place from the suggestions in the Location field.

Category, who, and labels

The assistant can choose only from the categories, who, and labels the calendar already has. It cannot create new ones: add them in schedule settings or from inside an event. See Category, who, and labels.

On an event from a source, the assistant does not see the category, who, and labels the source gives it by default. Setting who or labels on one of those events replaces all of the source's default who and labels on that event. Name any defaults you want to keep in the same request.

Sample prompts

Refer to a calendar, category, or label by the name it has in Agenda Hero.

Looking things up

"What calendars do I have in Agenda Hero?"
"What's on the Family planner this week?"
"When is the next early dismissal on the Lincoln Elementary planner?"
"Is anything on the Family planner on Saturday afternoon?"

Adding events

"Add a dentist appointment to the Family planner next Wednesday from 3:30 to 4:30 pm."
"Add piano lessons to the Family planner every Tuesday at 4 pm until December 15."
"Add a video call with Grandma to the Family planner at 7 pm Pacific time on Sunday."
"Add these games to the Soccer planner:" followed by the pasted schedule.

Changing and removing events

"Move the dentist appointment on the Family planner to 4 pm."
"Move Saturday's game on the Soccer planner to Field 3 at Riverside Park."
"Add 'Bring shin guards' to the description of every game on the Soccer planner."
"Add the Fundraiser label to the car wash on the PTA planner."
"Remove the bake sale from the PTA planner."

Events the assistant cannot change

Events that come from a source are read-only on your planner. That covers events from a Google calendar or a calendar link, and events from another Agenda Hero page or planner.

The assistant can read these events and is told that they are read-only. It can still change their category, who, and labels on your planner, because those belong to your planner rather than to the event. It cannot change their title, time, or other details, and it cannot remove them.

Those changes have to be made where the event lives: in the outside calendar, or on the Agenda Hero calendar that owns it. Your planner picks up the change from there, as described in How often a source updates.

The assistant is not told which calendar a read-only event comes from. Open the event in Agenda Hero to see it: the editor shows This item is from and the source's name.

Disconnecting

Remove the connector in the assistant:

Claude: open Customize, then Connectors, and remove Agenda Hero.
Claude Code: run claude mcp remove agendahero.
ChatGPT: open Settings, then Plugins, select Agenda Hero, and choose Disconnect from its ••• menu.

Once the connector is removed, the assistant stops using your Agenda Hero account. The approval you gave stays in Agenda Hero, so connecting the same assistant again can skip the consent screen.

Troubleshooting

Claude or Claude Code cannot reach Agenda Hero. The server URL has to be exactly https://agendahero.com/api/mcp, with no trailing slash.

ChatGPT shows Disabled by admin. An admin of your ChatGPT workspace has to enable Agenda Hero: in the Admin console, select the workspace and open Plugins.

The assistant says the connection is not allowed to do something. The message names the missing permission, such as events:write. Disconnect Agenda Hero in the assistant, connect it again, and choose Allow access.

The assistant cannot change an event. The event comes from a source (see Events the assistant cannot change), or you do not have edit access to that calendar.

The assistant says a category or label does not exist. The assistant can choose only from the categories, who, and labels the calendar already has. Add the new one in schedule settings or from inside an event, then ask again.

Agenda Hero does not support this assistant yet. Agenda Hero shows this message when an assistant it does not work with tries to connect. To ask about support for another assistant, email [email protected] with its name.

Last updated October 15, 2026