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. Every assistant connects to the same 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

ChatGPT connects to MCP servers in developer mode, which is available on the web for Plus, Pro, Business, Enterprise, and Edu accounts. In a Business, Enterprise, or Edu workspace, an admin has to allow developer mode first.

Open Settings, then Security and login, and turn on Developer mode.
Create a developer mode app. Enter Agenda Hero as the name and https://agendahero.com/api/mcp as the MCP server URL, and choose OAuth for authentication.
Sign in to Agenda Hero and choose Allow access. See Signing in and approving.

To use the connector in a chat, open the + menu, choose Developer mode, and select Agenda Hero.

OpenAI's developer mode guide 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

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.
Read events on a calendar, for all dates or for a date range.
Add events, one at a time or several in one request.
Change an event: its title, emoji, description, date and time, time zone, or repeat pattern.
Remove an event.

It cannot set an event's location, category, who, labels, or notes.

The assistant has the same access you do. It can read any calendar you can open, and it can add, change, and remove events 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.

Sample prompts

Refer to a calendar 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."
"Add 'Bring shin guards' to the description of every game on the Soccer 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. A change to one has 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: delete the Agenda Hero app in ChatGPT's settings.

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

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

The assistant says the connection is not allowed to do something. The message names the missing permission, such as events:write. Remove the connector, add 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.

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 September 23, 2026