addevent_create_calendar

WRITE: creates a new calendar in the AddEvent account (a new, empty calendar; nothing existing is changed and nobody is notified). Needs a title. POST /calendars.

Argument	Type	Description
title*	string	Calendar title (single line).
timezone	string	Default timezone for events on this calendar (IANA name).
custom_data	object	Arbitrary key-value pairs to store on the object (snake_case keys), e.g. an external id.
description	string	Shown on the calendar landing page.
internal_name	string	Internal name, never shown publicly.
weekday_begin	string	First day of the week.
calendar_color	integer	Color 1-20 from the palette.
landing_page_template_id	string	Calendar landing page template id, or 'default' (see addevent_list_calendar_templates).
embeddable_calendar_template_id	string	Embeddable calendar template id, or 'default'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Calendar title (single line)."
    },
    "timezone": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Default timezone for events on this calendar (IANA name)."
    },
    "custom_data": {
      "type": "object",
      "description": "Arbitrary key-value pairs to store on the object (snake_case keys), e.g. an external id.",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    },
    "description": {
      "type": "string",
      "maxLength": 5000,
      "description": "Shown on the calendar landing page."
    },
    "internal_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Internal name, never shown publicly."
    },
    "weekday_begin": {
      "enum": [
        "sunday",
        "monday"
      ],
      "type": "string",
      "description": "First day of the week."
    },
    "calendar_color": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Color 1-20 from the palette."
    },
    "landing_page_template_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Calendar landing page template id, or 'default' (see addevent_list_calendar_templates)."
    },
    "embeddable_calendar_template_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Embeddable calendar template id, or 'default'."
    }
  }
}

addevent_create_event

WRITE: creates a new event on a calendar (the account's default calendar if calendar_id is omitted). Creates a public event landing page and share links; it does not e-mail anyone, though people subscribed to that calendar's feed will see the event on their next sync. Needs title and datetime_start. POST /events.

Argument	Type	Description
color	integer	Color 1-20 from the palette.
title*	string	Event title (single line).
location	string	Address or URL (meeting link). Use either location or location_id, not both.
reminder	integer	Minutes before the start for a calendar-app reminder (0-10800).
timezone	string	IANA timezone for the start/end (default: the calendar's timezone), or 'floating'.
free_busy	string	How the event shows in an attendee's calendar.
calendar_id	any	Calendar to add the event to (see addevent_list_calendars); default calendar if omitted.
custom_data	object	Arbitrary key-value pairs to store on the object (snake_case keys), e.g. an external id.

addevent_create_rsvp_attendee

WRITE: adds ONE RSVP attendee (one e-mail address, personal data) to an event. This server never asks AddEvent to send the confirmation or organizer notification e-mails, but the event's own reminder and follow-up e-mails (if the event has them) will later go to this address, so only add someone who really RSVP'd. The e-mail must be unique per event. POST /events/{id}/rsvps.

Argument	Type	Description
email*	string	Attendee e-mail address (unique per event).
event_id*	any	Event id (evt-...) to RSVP to.
attending	string	The attendee's response.
rsvp_form_data	object	Answers to the event's RSVP form as field-name -> value. The default form needs {"name": "..."}.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 254,
      "description": "Attendee e-mail address (unique per event)."
    },
    "event_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\S+$",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "Event id (evt-...) to RSVP to."
    },
    "attending": {
      "enum": [
        "going",
        "maybe",
        "not-going"
      ],
      "type": "string",
      "description": "The attendee's response."
    },
    "rsvp_form_data": {
      "type": "object",
      "description": "Answers to the event's RSVP form as field-name -> value. The default form needs {\"name\": \"...\"}.",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  }
}

addevent_get_calendar

One calendar by id: title, timezone, week start, template ids, subscriber and event counts, links, custom data. GET /calendars/{id}.

read-only

Argument	Type	Description
calendar_id*	any	Calendar id (see addevent_list_calendars).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "calendar_id"
  ],
  "properties": {
    "calendar_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\S+$",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "Calendar id (see addevent_list_calendars)."
    }
  }
}

addevent_get_calendar_subscriber

One calendar subscriber by id (personal data; IP address and coordinates removed). GET /subscribers/{id}.

read-only

Argument	Type	Description
subscriber_id*	any	Subscriber id (see addevent_list_calendar_subscribers).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "subscriber_id"
  ],
  "properties": {
    "subscriber_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\S+$",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "Subscriber id (see addevent_list_calendar_subscribers)."
    }
  }
}

addevent_get_event

One event by id (evt-...): all fields incl. description, organizer, reminder, recurring rule, RSVP settings and stats, custom data and share links. GET /events/{id}.

read-only

Argument	Type	Description
event_id*	any	Event id, like evt-0f571af553d8437eb6a9ce22384fdcba (see addevent_list_events).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\S+$",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "Event id, like evt-0f571af553d8437eb6a9ce22384fdcba (see addevent_list_events)."
    }
  }
}

addevent_get_rsvp_attendee

One RSVP attendee by id (personal data: e-mail and form answers; IP address and coordinates removed). GET /rsvps/{id}.

read-only

Argument	Type	Description
attendee_id*	any	RSVP attendee id (see addevent_list_rsvp_attendees).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "attendee_id"
  ],
  "properties": {
    "attendee_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\S+$",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "RSVP attendee id (see addevent_list_rsvp_attendees)."
    }
  }
}

addevent_list_calendar_subscribers

List people subscribed to the account's calendars (personal data: the form answers they gave, such as name and e-mail; calendar app type, sync status). Paged, 20 at most per page. IP address and coordinates are removed. GET /subscribers.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
status	string	active = synced in the last 30 days; inactive = not; blocked = blocked by the owner. AddEvent returns only active ones when omitted, so call once per status.
sort_by	string
page_size	integer	Results per page, 1-20 (default 10).
sort_order	string	Sort direction. Needs sort_by.
calendar_ids	array	Only subscribers of these calendar ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "status": {
      "enum": [
        "active",
        "inactive",
        "blocked"
      ],
      "type": "string",
      "description": "active = synced in the last 30 days; inactive = not; blocked = blocked by the owner. AddEvent returns only active ones when omitted, so call once per status."
    },
    "sort_by": {
      "enum": [
        "created",
        "synced",
        "calendar_id"
      ],
      "type": "string"
    },
    "page_size": {
      "type": "integer",
      "maximum": 20,
      "description": "Results per page, 1-20 (default 10).",
      "exclusiveMinimum": 0
    },
    "sort_order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction. Needs sort_by."
    },
    "calendar_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^\\S+$",
            "maxLength": 100,
            "minLength": 1
          },
          {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          }
        ],
        "description": "The id (text or number)."
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Only subscribers of these calendar ids."
    }
  }
}

addevent_list_calendar_templates

The account's calendar landing page templates or embeddable calendar templates (id, name), newest first. Use the id as landing_page_template_id / embeddable_calendar_template_id on a calendar. GET /calendars/templates.

read-only

Argument	Type	Description
type	string	calendar-landing (default) or calendar-embed (embeddable calendars).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "type": {
      "enum": [
        "calendar-landing",
        "calendar-embed"
      ],
      "type": "string",
      "description": "calendar-landing (default) or calendar-embed (embeddable calendars)."
    }
  }
}

addevent_list_calendars

List the account's calendars (newest first by default) with id, title, timezone, whether it is the default calendar, landing-page links and counts of events and subscribers. GET /calendars.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
sort_by	string	Sort field (default created).
page_size	integer	Results per page, 1-20 (default 10).
sort_order	string	Sort direction. Needs sort_by.
calendar_ids	array	Only these calendar ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "sort_by": {
      "enum": [
        "created",
        "title"
      ],
      "type": "string",
      "description": "Sort field (default created)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 20,
      "description": "Results per page, 1-20 (default 10).",
      "exclusiveMinimum": 0
    },
    "sort_order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction. Needs sort_by."
    },
    "calendar_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^\\S+$",
            "maxLength": 100,
            "minLength": 1
          },
          {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          }
        ],
        "description": "The id (text or number)."
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Only these calendar ids."
    }
  }
}

addevent_list_event_templates

The account's event landing page templates (id, name), newest first. Use the id as landing_page_template_id on an event. GET /events/templates.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

addevent_list_events

Search the account's events (newest created first; by start time when a date filter is used): title, start/end, timezone, location, RSVP settings and stats, landing-page links. Filter by calendar, event ids, text, date window or a custom_data pair. GET /events.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
search	string	Case-insensitive text in title, internal name, description or location.
sort_by	string	Sort field.
event_ids	array	Only these event ids.
page_size	integer	Results per page, 1-20 (default 10).
ends_after	string	Only events that end after this date-time (datetime_min; naive comparison, timezones ignored).
sort_order	string	Sort direction. Needs sort_by.
calendar_ids	array	Only events on these calendar ids.
starts_before

addevent_list_rsvp_attendees

List RSVP attendees (personal data: e-mail addresses and the answers they gave on the RSVP form). Filter by calendar, event or response (going/maybe/not-going). Paged, 20 at most per page: read only what the task needs. IP address and coordinates are removed from the reply. GET /rsvps.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
sort_by	string
attending	string	Only attendees with this response.
event_ids	array	Only attendees of these event ids.
page_size	integer	Results per page, 1-20 (default 10).
sort_order	string	Sort direction. Needs sort_by.
calendar_ids	array	Only attendees of events on these calendar ids.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "sort_by": {
      "enum": [
        "created",
        "event_id",
        "attending",
        "email"
      ],
      "type": "string"
    },
    "attending": {
      "enum": [
        "going",
        "maybe",
        "not-going"
      ],
      "type": "string",
      "description": "Only attendees with this response."
    },
    "event_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^\\S+$",
            "maxLength": 100,
            "minLength": 1
          },
          {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          }
        ],
        "description": "The id (text or number)."
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Only attendees of these event ids."
    },
    "page_size": {
      "type": "integer",
      "maximum": 20,
      "description": "Results per page, 1-20 (default 10).",
      "exclusiveMinimum": 0
    },
    "sort_order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction. Needs sort_by."
    },
    "calendar_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^\\S+$",
            "maxLength": 100,
            "minLength": 1
          },
          {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          }
        ],
        "description": "The id (text or number)."
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Only attendees of events on these calendar ids."
    }
  }
}

addevent_list_rsvp_forms

The account's RSVP forms (id, name), newest first. Use the id as rsvp_form_id on an event. GET /events/rsvp-forms.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

addevent_list_timezones

Timezone names AddEvent supports (use them as the timezone of events and calendars), with current UTC offset. Optional text filter on the name. GET /timezones.

read-only

Argument	Type	Description
limit	integer	Most entries to return (default 100).
search	string	Case-insensitive part of the name, e.g. 'Prague' or 'America/'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 500,
      "description": "Most entries to return (default 100).",
      "exclusiveMinimum": 0
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Case-insensitive part of the name, e.g. 'Prague' or 'America/'."
    }
  }
}

addevent_update_calendar

WRITE: changes fields of an existing calendar (only the fields you pass; the rest stay). Title, description and timezone changes show on its landing page and can reach people who subscribe to the calendar feed. Not reversible by this server (no previous values are kept), so read the calendar first. PATCH /calendars/{id}.

destructive

Argument	Type	Description
title	string	New title (single line).
timezone	string	IANA timezone such as America/Los_Angeles, or 'floating' (same local time for everyone). See addevent_list_timezones.
calendar_id*	any	Calendar id to change.
custom_data	object	Key-value pairs to store on the calendar (snake_case keys).
description	string
internal_name	string	Internal name, never shown publicly.
weekday_begin	string
calendar_color	integer	Color 1-20 from the palette.

addevent_update_event

WRITE: changes fields of an existing event (only the fields you pass; the rest stay). The change goes live on its landing page and share links, and people who subscribed to the calendar or added the event with a live link are updated on their next calendar sync, so a time or location change can notify real people. No previous values are kept: read the event first. PATCH /events/{id}.

destructive

Argument	Type	Description
color	integer	Color 1-20 from the palette.
title	string	New title (single line).
event_id*	any	Event id (evt-...) to change.
location	string	Address or URL (meeting link). Use either location or location_id, not both.
reminder	integer	Minutes before the start for a calendar-app reminder (0-10800).
timezone	string	IANA timezone for the start/end (default: the calendar's timezone), or 'floating'.
free_busy	string	How the event shows in an attendee's calendar.
calendar_id	any

addevent_update_rsvp_attendee

WRITE: changes ONE RSVP attendee (email, response or form answers; only the fields you pass). The event's reminder and update e-mails go to the e-mail address stored here, so changing it redirects those e-mails to that person. This server never triggers the confirmation or organizer notification e-mails. PATCH /rsvps/{id}.

destructive

Argument	Type	Description
email	string	New e-mail address.
attending	string
attendee_id*	any	RSVP attendee id.
rsvp_form_data	object	Answers to the event's RSVP form as field-name -> value. The default form needs {"name": "..."}.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "attendee_id"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 254,
      "description": "New e-mail address."
    },
    "attending": {
      "enum": [
        "going",
        "maybe",
        "not-going"
      ],
      "type": "string"
    },
    "attendee_id": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\S+$",
          "maxLength": 100,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "RSVP attendee id."
    },
    "rsvp_form_data": {
      "type": "object",
      "description": "Answers to the event's RSVP form as field-name -> value. The default form needs {\"name\": \"...\"}.",
      "propertyNames": {
        "type": "string",
        "maxLength": 100,
        "minLength": 1
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2000
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ]
      }
    }
  }
}

AddEvent MCP by usefulapi

Try it

addevent_create_calendar

AddEvent MCP by usefulapi

Try it

addevent_create_calendar

Tools (18)