Skip to the main deck

The CalendarPA MCP server

CalendarPA has an MCP server, so ChatGPT, Claude, or any other agent can work yer CalendarPA account. Once it be connected, the assistant can see yer bookin' types an' bookin's, find open times, an' book, reschedule or scuttle parleys fer ye. It signs in with yer CalendarPA account, so there be no API key to copy. Every plan can connect, the Free plan included.

Server URL

https://calendarpa.com/api/mcp

Paste this address exactly as shown, /api/mcp an' all.

Connect from Claude

Add t' Claude

Or add it by hand as a custom connector, matey:

  1. In Claude, open Customize, then Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it CalendarPA, paste the server URL an' click Continue.
  4. Click Continue past the sign-in settings Claude spies.
  5. Under OAuth client, choose Register automatically, then click Add.
  6. Sign in to CalendarPA when asked an' approve the permissions.
  7. In a chat, click +, then Connectors, an' turn CalendarPA on.

In the Claude app on iPhone, open Connectors an' tap Connect next to CalendarPA.

On a Claude Team or Enterprise plan, an owner adds the connector under Organization settings, then Connectors, an' each crew member then connects it from Customize, then Connectors.

These steps follow Claude's help article on custom connectors. Claude may rename its menus.

Connect from ChatGPT

  1. In ChatGPT, open Plugins.
  2. Select the plus button, then Add custom MCP server.
  3. Name it CalendarPA an', under Connection, paste the server URL.
  4. Choose OAuth fer authentication, read the warnin' an' select I understand and want to continue.
  5. Select Create as a plugin, then sign in to CalendarPA an' approve the permissions.
  6. In a new chat, type @ an' pick CalendarPA.

Whether yer ChatGPT account can add a custom MCP server be set by ChatGPT's own account an' workspace rules.

These steps follow OpenAI's guide to connectin' an MCP server. ChatGPT may rename its menus.

The three permissions

When ye sign in, CalendarPA asks ye to approve three permissions. Each one covers only the tools listed beside it.

If ye be already signed in to CalendarPA in that browser or app, ye go straight to the permissions without signin' in again. The page shows Connectin' as with yer name an' email. If that ain't the account ye want, click Not ye? Switch account, matey before ye approve.

  • View yer bookin' types: list yer bookin' types an' find their open times.
  • View yer bookin's and bookin' particulars: list yer bookin's an' read one bookin'.
  • Craft and scuttle bookin's on yer behalf: book, reschedule an' scuttle.

No permission an assistant be given lets it hand back a payment.

What the assistant can do

ToolWhat it doesKind
whoamiThe account it be connected to: name, email, username, plan an' time zone.Read
list_booking_typesYer live bookin' types, with title, length, location choices an' price.Read
find_available_timesOpen times fer one bookin' type, as yer bookin' page offers them. Up to 60 days per call.Read
list_bookingsBookin's ye host, plus round-robin bookin's handed to ye. Can filter by status, date created or invitee email.Read
get_bookingOne bookin's time, status, invitee, location an' meetin' link.Read
create_bookingBooks a time that find_available_times offered. The invitee gets the usual confirmation an' the parley goes on yer calendar.Write, destructive
reschedule_bookingMoves a bookin' ye host to a new time.Write, destructive
cancel_bookingScuttles a bookin' ye host an' tells the invitee. Fer a bookin' paid by card the payment be kept; credits spent to pay go back.Write, destructive

What it can't do

  • Book a paid bookin' type.
  • Move or scuttle a spot in a group session.
  • List bookin's ye co-host.
  • Hand back a payment.

Plans

The MCP server works on every plan, the Free plan included. If an action uses a feature yer plan don't include, such as recurrin' bookin's, the assistant be told which plan has it.

Limits

  • Up to 300 tool calls a minute per connection, within 1,000 a minute per account.
  • Findin' open times reads yer calendars live, so it be limited to 30 calls a minute per account.
  • Past a limit, the assistant be told how many seconds to wait afore tryin' again.
  • A result bigger than 100 KB be refused rather than cut short, so the assistant narrows its askin'.
  • Access lasts 1 hour at a time an' can be renewed fer up to 90 days without use. If the connection stops workin', connect it again.

Cut it loose

In CalendarPA, go to Ship's Riggin', then Riggin', find the app under Lashed-On Apps an' click Cut Loose. Access stops at once: the assistant's next request be refused.

Privacy

The assistant can reach only yer own account, an' only what the permissions ye approved allow. What ChatGPT, Claude, or any other agent does with what it reads be covered by their own privacy terms; ours be the Privacy Policy.

Fer developers

The server speaks MCP over Streamable HTTP an' signs in with OAuth, usin' PKCE an' dynamic client registration. Its protected resource metadata be at /.well-known/oauth-protected-resource/api/mcp. The REST API be charted in the API docs.