​
What can you do with it?

Manage and schedule meetings with Calendly, including retrieving current user information, getting event type details, searching scheduled events, getting specific event details, retrieving event invitees, and managing calendar scheduling workflows for efficient meeting coordination.

​
How to use it?

​
Basic Command Structure

/your-calendly-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:

  • action - The operation to perform (get-current-user, get-event-type, search-events, get-event, get-event-invitees)

Optional:

  • event-type-uuid - Event type UUID
  • event-uuid - Event UUID
  • user-uri - User URI URL
  • status - Event status (active, canceled)
  • start-date - Start date for event search
  • end-date - End date for event search

​
Tools

​
Get Current User

Retrieve the current user’s Calendly information

Parameters:

  • No parameters required

Example:

/your-calendly-connection
action: get-current-user

Response:

{
  "resource": {
    "avatar_url": null,
    "created_at": "2025-05-14T16:18:41.756033Z",
    "current_organization": "https://api.calendly.com/organizations/xxx",
    "email": "user@example.com",
    "locale": "en",
    "name": "user name",
    "resource_type": "User",
    "scheduling_url": "https://calendly.com/user-domain",
    "slug": "user-domain",
    "time_notation": "24h",
    "updated_at": "2025-05-14T16:39:27.080754Z",
    "uri": "https://api.calendly.com/users/userid-xxx"
  }
}

​
Get Event Type

Retrieve details of a specific event type

Parameters:

  • event-type-uuid (required) - Event type UUID

Example:

/your-calendly-connection
action: get-event-type
event-type-uuid: 12345678-1234-1234-1234-123456789012

Response:

{
  "resource": {
    "uri": "https://api.calendly.com/event_types/12345678-1234-1234-1234-123456789012",
    "name": "30 Minute Meeting",
    "description": "A 30-minute meeting",
    "duration": 30,
    "active": true
  }
}

​
Search Events

Retrieve a list of scheduled events based on query parameters

Parameters:

  • user-uri (required) - User URI URL from get-current-user
  • status (optional) - Event status (active, canceled)
  • start-date (optional) - Start date for search
  • end-date (optional) - End date for search

Example:

/your-calendly-connection
action: search-events
user-uri: https://api.calendly.com/users/userid-xxx
status: active
start-date: 2025-01-01T00:00:00Z
end-date: 2025-01-31T23:59:59Z

Response:

{
  "collection": [
    {
      "calendar_event": {
        "external_id": "external_id_123",
        "kind": "google"
      },
      "created_at": "2025-01-15T10:00:00Z",
      "end_time": "2025-01-15T11:00:00Z",
      "event_guests": [],
      "event_memberships": [
        {
          "buffered_end_time": "2025-01-15T11:15:00Z",
          "buffered_start_time": "2025-01-15T10:45:00Z",
          "user": "https://api.calendly.com/users/userid-xxx",
          "user_email": "user@example.com",
          "user_name": "User Name"
        }
      ],
      "event_type": "https://api.calendly.com/event_types/event-type-uuid",
      "invitees_counter": {
        "active": 1,
        "limit": 1,
        "total": 1
      },
      "location": {
        "join_url": "https://zoom.us/j/123456789",
        "status": "pushed",
        "type": "zoom"
      },
      "meeting_notes_html": null,
      "meeting_notes_plain": null,
      "name": "30 Minute Meeting",
      "start_time": "2025-01-15T10:00:00Z",
      "status": "active",
      "updated_at": "2025-01-15T10:00:00Z",
      "uri": "https://api.calendly.com/scheduled_events/event-uuid"
    }
  ],
  "pagination": {
    "count": 1,
    "next_page": null,
    "next_page_token": null,
    "previous_page": null,
    "previous_page_token": null
  }
}

​
Get Event

Retrieve details of a scheduled event using its unique ID

Parameters:

  • event-uuid (required) - Event UUID

Example:

/your-calendly-connection
action: get-event
event-uuid: abcd1234-5678-9012-3456-789012345678

Response:

{
  "resource": {
    "uri": "https://api.calendly.com/scheduled_events/abcd1234-5678-9012-3456-789012345678",
    "name": "30 Minute Meeting",
    "start_time": "2025-01-01T10:00:00Z",
    "end_time": "2025-01-01T10:30:00Z",
    "status": "active",
    "event_type": "https://api.calendly.com/event_types/event-type-uuid",
    "location": {
      "join_url": "https://zoom.us/j/123456789",
      "status": "pushed",
      "type": "zoom"
    },
    "invitees_counter": {
      "active": 1,
      "limit": 1,
      "total": 1
    }
  }
}

​
Get Event Invitees

Retrieve a list of invitees for a specific scheduled event

Parameters:

  • event-uuid (required) - Event UUID

Example:

/your-calendly-connection
action: get-event-invitees
event-uuid: abcd1234-5678-9012-3456-789012345678

Response:

{
  "collection": [
    {
      "uri": "https://api.calendly.com/scheduled_events/abcd1234/invitees/invitee1",
      "email": "invitee1@example.com",
      "name": "Invitee One",
      "status": "accepted",
      "created_at": "2025-01-01T09:00:00Z",
      "updated_at": "2025-01-01T09:30:00Z"
    },
    {
      "uri": "https://api.calendly.com/scheduled_events/abcd1234/invitees/invitee2",
      "email": "invitee2@example.com",
      "name": "Invitee Two",
      "status": "accepted",
      "created_at": "2025-01-01T09:15:00Z",
      "updated_at": "2025-01-01T09:45:00Z"
    }
  ],
  "pagination": {
    "count": 2,
    "next_page": null
  }
}

​
Notes

Calendly API requires user URI from get-current-user for most operations. First-person pronouns (I, me, my, mine) automatically trigger user information retrieval. Event UUIDs are required for specific event operations. All timestamps are in ISO 8601 format. Event types define meeting templates and availability settings. Invitees can have different statuses (accepted, declined, pending). Location information includes join URLs for video meetings.