42min

    Help AI assistants (MCP)

    What your assistant can do

    A connected assistant works with 42min through a fixed set of 24 tools. You don't call these yourself — the assistant picks the right one from your request ("find me a slot tomorrow" becomes a find_available_slots call). This page lists them all in plain language, so you know exactly what an assistant can and cannot do with your account.

    Which tools an assistant actually gets depends on the access it was granted — an assistant connected with a read-only personal access token sees only the reading tools. And every tool respects your dashboard role — see Permissions and security.

    Availability and slots

    Tool What it does
    find_available_slots Lists open booking slots for an event type over a date range (up to 31 days at a time).
    check_slot Checks whether one specific start time is bookable.
    get_schedules Reads your own availability schedules — weekly hours and date overrides.
    add_schedule_override Adds or replaces a date-specific override on one of your schedules.

    Bookings and meetings

    Tool What it does
    list_bookings Lists bookings, filtered by status, date range, event type, attendee, or host.
    get_booking Full detail for one booking — form responses, location or conferencing link, no-show status.
    create_booking Books a meeting for an attendee on any active event type in your organization — the same thing the public booking page allows.
    cancel_booking Cancels a booking. The attendee is notified and the calendar event is removed.
    reschedule_booking Moves a booking to a new time.
    list_meetings Your host-side meetings view — upcoming, past, or a date range.
    set_meeting_no_show Marks (or unmarks) a past meeting as a no-show.

    Event types

    Tool What it does
    list_event_types Lists event types, optionally filtered by status, host, or slug.
    get_event_type Full detail for one event type — duration, location, booking questions, limits.
    set_event_type_status Turns an event type on or off. Turning it off immediately stops new public bookings.

    Contacts

    Tool What it does
    search_contacts Searches contacts by name or email, with meeting counts and tags.
    get_contact One contact plus their meeting history.
    Tool What it does
    create_single_use_links Generates one-time booking links (1–10 at a time) for an event type you manage.
    list_single_use_links Lists your one-time links with created / booked / expired status.
    delete_single_use_link Deletes an unused one-time link so it can no longer be used.

    Roundtables (group scheduling polls)

    Tool What it does
    list_roundtables Lists your roundtables with status, vote counts, and the confirmed time.
    get_roundtable Full poll state — candidate slots, participants, vote tallies.
    create_roundtable Creates a draft poll with candidate time slots and participants. Drafts send no emails and place no calendar holds.
    publish_roundtable Publishes a draft — opens voting, emails every invited participant, and places tentative calendar holds. Assistants are instructed to confirm with you before calling this, because it can't be undone through MCP.

    Your profile

    Tool What it does
    get_me Your own profile — name, username, time zone, language — plus your organization and role.

    What it can't do

    There are deliberately no tools for some things, no matter what access was granted:

    • Create or delete event types. The assistant can list, inspect, and toggle them, but building an event type stays in the dashboard.
    • Change org settings, users, teams, or branding — no admin-center tools.
    • Manage webhooks, routing forms, or workflows.
    • Act for your invitees. Attendees book, reschedule, and cancel through your booking page and their emailed links, not through an assistant.

    Common pitfalls

    • Booked a colleague's event type, now the assistant can't cancel it. A booking created on someone else's event type behaves like one made through their public page: the attendee manages it via the emailed reschedule and cancel links, and only people with access to that host's bookings can touch it in 42min.
    • "Publish" is permanent. Publishing a roundtable emails all participants immediately — that can't be recalled. Keep polls as drafts until they're ready.
    • Safety on retries. Booking-creating tools are idempotent: if the assistant retries after a timeout, 42min recognizes the repeat and won't double-book. In rare cases a duplicate notification email can go out even though the booking itself was created exactly once.

    Last updated July 28, 2026.

    PreviousConnecting your assistantNext Permissions and security