universal-mcp-applications 0.1.17__py3-none-any.whl → 0.1.33__py3-none-any.whl

universal_mcp/applications/google_calendar/README.md

@@ -9,13 +9,13 @@ This is automatically generated from OpenAPI schema for the GoogleCalendarApp AP
 
 | Tool | Description |
 |------|-------------|
-| `get_event` | Retrieves detailed information about a specific Google Calendar event by its ID |
-| `get_today_events` | Retrieves events from Google Calendar for today or a specified number of future days. |
-| `list_events` | Retrieves a list of events from Google Calendar with customizable filtering, sorting, and pagination options |
-| `quick_add_event` | Creates a calendar event. Use it only when user specfies that they want to add a quick event |
-| `add_an_event` | Creates a new calendar event with details like start time, end time, summary, description, location, attendees, and recurrence rules. |
-| `update_event` | Updates an existing calendar event. This method updates the entire event resource. |
-| `get_event_instances` | Retrieves all instances of a recurring calendar event within a specified time range. |
-| `get_user_timezone` | Gets the user's calendar timezone setting to help with timezone-aware event creation. |
-| `delete_event` | Deletes an event from the specified calendar. |
-| `query_free_busy` | Checks if you have free slots or not by querying the free/busy status of your calendars. |
+| `get_event_by_id` | Retrieves a specific calendar event using its unique ID. Unlike `list_events`, which fetches multiple events based on date ranges or search queries, this function targets a single, known event. It can optionally limit attendees returned and specify a time zone for date formatting in the response. |
+| `get_upcoming_events` | Retrieves events for a specified number of days, starting from today. This function simplifies date-range queries by auto-calculating start/end times, unlike the more comprehensive `list_events` function, which offers granular control with explicit time filters, text search, and custom sorting. |
+| `list_events` | Fetches a customizable list of events using filters for date range, text search, sorting, and pagination. This advanced function provides more granular control than `get_upcoming_events`, which is limited to fetching events for a specific number of upcoming days. |
+| `create_event_from_text` | Creates a calendar event by parsing a natural language string (e.g., "Meeting tomorrow at 10am"). This offers a user-friendly shortcut, contrasting with the structured `create_event` function which requires explicit fields like start and end times. |
+| `create_event` | Creates a calendar event using structured data for start/end times, summary, attendees, and recurrence. This method provides precise control for complex appointments, unlike `create_event_from_text` which parses natural language, making it ideal for detailed or recurring event creation. |
+| `replace_event` | Replaces an existing calendar event, identified by its ID, with new data. This function performs a full update, overwriting all event properties like start/end times and summary. It does not support partial modifications, requiring all necessary fields for the replacement to be provided. |
+| `list_recurring_event_instances` | Retrieves all individual occurrences of a specific recurring event using its ID. Unlike `list_events`, which fetches multiple distinct events, this function expands a single recurring event into its separate instances, allowing filtering by time range and pagination for detailed scheduling views. |
+| `get_primary_calendar_details` | Retrieves metadata for the user's primary calendar, including its default timezone. This information is essential for creating new events with accurate, timezone-aware start and end times using other functions like `create_event`, preventing potential scheduling errors across different regions. |
+| `delete_event` | Permanently deletes a specific event from a Google Calendar using its event and calendar IDs. It can optionally send cancellation notifications to attendees, distinguishing it from functions that retrieve (`get_event_by_id`) or modify events (`replace_event`), which do not remove entries from the calendar. |
+| `get_free_busy_info` | Queries the free/busy status for one or more calendars within a specified time range. It returns a list of busy time intervals, making it ideal for finding open slots and scheduling new events without conflicts. |

universal_mcp/applications/google_calendar/app.py

@@ -2,7 +2,6 @@ from datetime import UTC, datetime, timedelta
 from typing import Any
 
 from loguru import logger
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -54,19 +53,19 @@ class GoogleCalendarApp(APIApplication):
         time_zone: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves calendar events for a specified number of days starting from today. It defaults to fetching only the current day's events, simplifying date-range queries for upcoming events in contrast to the more comprehensive `list_events` function which requires explicit start and end times.
-        
+        Retrieves events for a specified number of days, starting from today. This function simplifies date-range queries by auto-calculating start/end times, unlike the more comprehensive `list_events` function, which offers granular control with explicit time filters, text search, and custom sorting.
+
         Args:
             days: Number of days to retrieve events for (default: 1, which is just today)
             max_results: Maximum number of events to return (optional)
             time_zone: Time zone used in the response (optional, default is calendar's time zone)
-        
+
         Returns:
             Dictionary containing the complete API response with all events and metadata
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
-        
+
         Tags:
             fetch, list, calendar, events, date-time, important, api
         """
@@ -98,20 +97,20 @@ class GoogleCalendarApp(APIApplication):
         time_zone: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves a specific Google Calendar event using its unique ID. Optional parameters can limit the number of attendees returned and specify a time zone for formatting dates. It is distinct from `list_events`, which fetches multiple events based on broader criteria like date ranges or search queries.
-        
+        Retrieves a specific calendar event using its unique ID. Unlike `list_events`, which fetches multiple events based on date ranges or search queries, this function targets a single, known event. It can optionally limit attendees returned and specify a time zone for date formatting in the response.
+
         Args:
             event_id: The unique identifier of the calendar event to retrieve
             max_attendees: Optional. The maximum number of attendees to include in the response. If None, includes all attendees
             time_zone: Optional. The time zone to use for formatting dates in the response. If None, uses the calendar's default time zone
-        
+
         Returns:
             Dictionary containing the complete API response with all event details
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
             JSONDecodeError: Raised when the API response cannot be parsed as JSON
-        
+
         Tags:
             retrieve, calendar, event, api, important
         """
@@ -137,8 +136,8 @@ class GoogleCalendarApp(APIApplication):
         page_token: str | None = None,
     ) -> dict[str, Any]:
         """
-        Fetches a customizable list of events using filters for date range, text search, sorting, and pagination. This advanced function provides more granular control than `get_today_events`, which is limited to fetching events for a specific number of upcoming days.
-        
+        Fetches a customizable list of events using filters for date range, text search, sorting, and pagination. This advanced function provides more granular control than `get_upcoming_events`, which is limited to fetching events for a specific number of upcoming days.
+
         Args:
             max_results: Maximum number of events to return (default: 10, max: 2500)
             time_min: Start time in ISO format (e.g., '2023-12-01T00:00:00Z'). Defaults to current time if not specified
@@ -148,14 +147,14 @@ class GoogleCalendarApp(APIApplication):
             single_events: Whether to expand recurring events into individual instances (default: True)
             time_zone: Time zone for response formatting (defaults to calendar's time zone)
             page_token: Token for retrieving a specific page of results in paginated responses
-        
+
         Returns:
             Dictionary containing the complete API response with all events and metadata
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
             JSONDecodeError: Raised when the API response cannot be parsed as JSON
-        
+
         Tags:
             list, retrieve, calendar, events, pagination, api, important
         """
@@ -196,8 +195,8 @@ class GoogleCalendarApp(APIApplication):
         calendar_id: str = "primary",
     ) -> dict[str, Any]:
         """
-        Creates a detailed calendar event with structured data, including start/end times, summary, attendees, and recurrence rules. Unlike `quick_add_event`, which uses natural language, this method offers precise control for creating complex or recurring appointments.
-        
+        Creates a calendar event using structured data for start/end times, summary, attendees, and recurrence. This method provides precise control for complex appointments, unlike `create_event_from_text` which parses natural language, making it ideal for detailed or recurring event creation.
+
         Args:
             start: Start time of the event (required). Must include timezone offset or timeZone field.
                    Examples:
@@ -222,13 +221,13 @@ class GoogleCalendarApp(APIApplication):
                            "RRULE:FREQ=DAILY;UNTIL=20150628;INTERVAL=3"
                        ],
             calendar_id: Calendar identifier (default: "primary")
-        
+
         Returns:
             Dictionary containing the complete API response with the created event details
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
-        
+
         Tags:
             create, calendar, event, insert, recurring, important
         """
@@ -252,20 +251,22 @@ class GoogleCalendarApp(APIApplication):
 
         return self._handle_response(response)
 
-    def create_event_from_text(self, text: str, send_updates: str = "none") -> dict[str, Any]:
+    def create_event_from_text(
+        self, text: str, send_updates: str = "none"
+    ) -> dict[str, Any]:
         """
-        Creates a calendar event by parsing a natural language string for details like title and time. This provides a user-friendly shortcut for event creation, contrasting with the structured `add_an_event` method which requires explicit fields for start, end, and summary.
-        
+        Creates a calendar event by parsing a natural language string (e.g., "Meeting tomorrow at 10am"). This offers a user-friendly shortcut, contrasting with the structured `create_event` function which requires explicit fields like start and end times.
+
         Args:
             text: Natural language text describing the event (e.g., 'Meeting with John at Coffee Shop tomorrow 3pm-4pm')
             send_updates: Specifies who should receive event notifications: 'all', 'externalOnly', or 'none' (default)
-        
+
         Returns:
             Dictionary containing the complete API response with the created event details
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
-        
+
         Tags:
             create, calendar, event, quick-add, natural-language, important
         """
@@ -287,8 +288,8 @@ class GoogleCalendarApp(APIApplication):
         page_token: str | None = None,
     ) -> dict[str, Any]:
         """
-        Retrieves all individual occurrences (instances) of a specific recurring event, identified by its ID. This function allows filtering by a time range and supports pagination, distinguishing it from `list_events` which fetches multiple, distinct events rather than instances of a single one.
-        
+        Retrieves all individual occurrences of a specific recurring event using its ID. Unlike `list_events`, which fetches multiple distinct events, this function expands a single recurring event into its separate instances, allowing filtering by time range and pagination for detailed scheduling views.
+
         Args:
             event_id: ID of the recurring event
             max_results: Maximum number of event instances to return (default: 25, max: 2500)
@@ -297,14 +298,14 @@ class GoogleCalendarApp(APIApplication):
             time_zone: Time zone used in the response (defaults to calendar's time zone)
             show_deleted: Whether to include deleted instances (default: False)
             page_token: Token for retrieving a specific page of results
-        
+
         Returns:
             Dictionary containing the complete API response with all event instances and metadata
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
             JSONDecodeError: Raised when the API response cannot be parsed as JSON
-        
+
         Tags:
             list, retrieve, calendar, events, recurring, pagination, api, important
         """
@@ -341,8 +342,8 @@ class GoogleCalendarApp(APIApplication):
         userIp=None,
     ) -> Any:
         """
-        Deletes a specific event from a Google Calendar using its event and calendar IDs. This action is permanent and can optionally send cancellation notifications or updates to attendees based on the provided parameters.
-        
+        Permanently deletes a specific event from a Google Calendar using its event and calendar IDs. It can optionally send cancellation notifications to attendees, distinguishing it from functions that retrieve (`get_event_by_id`) or modify events (`replace_event`), which do not remove entries from the calendar.
+
         Args:
             calendarId (string): calendarId
             eventId (string): eventId
@@ -355,10 +356,10 @@ class GoogleCalendarApp(APIApplication):
             prettyPrint (string): Returns response with indentations and line breaks. Example: 'true'.
             quotaUser (string): An opaque string that represents a user for quota purposes. Must not exceed 40 characters. Example: 'amet in'.
             userIp (string): Deprecated. Please use quotaUser instead. Example: 'amet in'.
-        
+
         Returns:
             Any: No Content
-        
+
         Tags:
             calendars, {calendarId}, events, {eventId}
         """
@@ -400,8 +401,8 @@ class GoogleCalendarApp(APIApplication):
         max_attendees: int | None = None,
     ) -> dict[str, Any]:
         """
-        Replaces an existing calendar event, identified by its ID, with new data. This function performs a full update, overwriting all event properties like start/end times, summary, and attendees. It does not support partial modifications; all required fields for the new event version are necessary.
-        
+        Replaces an existing calendar event, identified by its ID, with new data. This function performs a full update, overwriting all event properties like start/end times and summary. It does not support partial modifications, requiring all necessary fields for the replacement to be provided.
+
         Args:
             event_id: The unique identifier of the calendar event to update (required)
             start: Start time of the event (required). Must include timezone offset or timeZone field.
@@ -423,13 +424,13 @@ class GoogleCalendarApp(APIApplication):
             calendar_id: Calendar identifier (default: "primary")
             send_updates: Specifies who should receive event notifications: 'all', 'externalOnly', or 'none' (default)
             max_attendees: Maximum number of attendees to include in the response (optional)
-        
+
         Returns:
             Dictionary containing the complete API response with the updated event details
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
-        
+
         Tags:
             update, calendar, event, modify, important
         """
@@ -458,14 +459,14 @@ class GoogleCalendarApp(APIApplication):
 
     def get_primary_calendar_details(self) -> dict[str, Any]:
         """
-        Retrieves metadata for the user's primary calendar, including its default timezone. This information is essential for creating new events with accurate, timezone-aware start and end times, as recommended before using functions like `add_an_event` to prevent scheduling errors across different regions.
-        
+        Retrieves metadata for the user's primary calendar, including its default timezone. This information is essential for creating new events with accurate, timezone-aware start and end times using other functions like `create_event`, preventing potential scheduling errors across different regions.
+
         Returns:
             Dictionary containing the user's timezone information
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
-        
+
         Tags:
             get, calendar, timezone, settings, important
         """
@@ -491,9 +492,9 @@ class GoogleCalendarApp(APIApplication):
         timeZone=None,
     ) -> dict[str, Any]:
         """
-        Queries the Google Calendar API to determine the free/busy status for one or more calendars within a specified time range. It returns a list of busy time intervals, useful for scheduling new events without conflicts.
-        
-        
+        Queries the free/busy status for one or more calendars within a specified time range. It returns a list of busy time intervals, making it ideal for finding open slots and scheduling new events without conflicts.
+
+
         Args:
             alt (string): Data format for the response. Example: 'json'.
             fields (string): Selector specifying which fields to include in a partial response. Example: 'amet in'.
@@ -526,7 +527,7 @@ class GoogleCalendarApp(APIApplication):
                   "timeZone": "UTC"
                 }
                 ```
-        
+
         Returns:
             dict[str, Any]: Successful response
         """

universal_mcp/applications/google_docs/README.md

@@ -9,17 +9,17 @@ This is automatically generated from OpenAPI schema for the GoogleDocsApp API.
 
 | Tool | Description |
 |------|-------------|
-| `create_document` | Creates a new blank Google Document with the specified title and returns the API response. |
-| `get_document` | Retrieves the latest version of a specified document from the Google Docs API. |
-| `add_content` | Adds text content at a specified position in an existing Google Document via the Google Docs API. |
-| `style_text` | Simplified text styling for Google Document - handles most common cases. |
-| `delete_content` | Deletes content from a specified range in a Google Document. |
-| `insert_table` | Inserts a table at the specified location in a Google Document. |
-| `create_footer` | Creates a Footer in a Google Document. |
-| `create_footnote` | Creates a Footnote segment and inserts a new FootnoteReference at the given location. |
-| `delete_footer` | Deletes a Footer from the document. |
-| `create_header` | Creates a Header in a Google Document. |
-| `delete_header` | Deletes a Header from the document. |
-| `create_paragraph_bullets` | Creates bullets for all of the paragraphs that overlap with the given range. |
-| `delete_paragraph_bullets` | Deletes bullets from all of the paragraphs that overlap with the given range. |
-| `update_paragraph_style` | Updates paragraph styling for a specified range in a Google Document. |
+| `create_document` | Creates a blank Google Document with a specified title using a POST request to the Google Docs API. This is the primary creation method, returning the document's metadata, including the ID required by functions like `get_document` or `insert_text` to perform subsequent operations on the new file. |
+| `get_document` | Retrieves the complete content and metadata for a specific Google Document using its unique ID. This function performs a GET request to the API, returning the full JSON response. It's the primary read operation, contrasting with `create_document` which creates new documents. |
+| `insert_text` | Inserts a text string at a specified index within an existing Google Document using the `batchUpdate` API. This function adds new textual content, distinguishing it from functions that insert non-text elements like tables or apply formatting (`apply_text_style`) to existing content. |
+| `apply_text_style` | Applies character-level formatting such as bold, italic, font size, color, and hyperlinks to a specified text range in a document. This function modifies text appearance, distinguishing it from `update_paragraph_style`, which handles block-level formatting like alignment and headings. |
+| `delete_content_range` | Deletes content within a specified index range in a Google Document via the batchUpdate API. It removes any content based on location, distinguishing it from functions like `delete_header` or `delete_paragraph_bullets`, which remove specific structures or styles instead. |
+| `insert_table` | Inserts a table with specified row and column dimensions at a given index in a Google Document. This function uses the `batchUpdate` API for precise placement, allowing the table to be added to the document's body, a header, or a footer, returning the API's response. |
+| `create_footer` | Creates a footer of a specified type in a Google Document via the batch update API. The footer can optionally be associated with a specific section break, enabling distinct footers for different document sections, distinguishing it from the `create_header` and `create_footnote` functions. |
+| `create_footnote` | Creates a footnote via the batch update API, inserting a numbered reference at a specified index or a segment's end. This function adds an in-body citation, distinguishing it from `create_footer` which creates a content block at the bottom of the page. |
+| `delete_footer` | Deletes a specific footer from a Google Document using its unique ID via a `batchUpdate` request. This operation, the counterpart to `create_footer`, removes an entire footer section, unlike `delete_content_range` which targets text within a specified index range. |
+| `create_header` | Creates a header in a specified Google Document via the batchUpdate API endpoint. This function allows defining the header type and can optionally associate it with a specific section break location. It complements the `delete_header` and `create_footer` functions for managing document structure. |
+| `delete_header` | Removes a specific header from a Google Document using its unique ID. This function sends a `deleteHeader` request to the batch update API, acting as the direct counterpart to `create_header` and distinguishing it from `delete_footer` which removes footers. |
+| `apply_list_style` | Applies a predefined bulleted or numbered list format to paragraphs within a specified range using a `bullet_preset`. This function adds list formatting, distinguishing it from its counterpart, `delete_paragraph_bullets`, and other styling functions like `update_paragraph_style`, which handles alignment and headings. |
+| `delete_paragraph_bullets` | Removes bullet points or numbering from paragraphs within a specified range in a Google Document. This function reverts list formatting via the batch update API, acting as the direct counterpart to `apply_list_style` and preserving the underlying text content, unlike `delete_content_range`. |
+| `update_paragraph_style` | Applies paragraph-level formatting, such as named styles (e.g., 'HEADING_1'), alignment, or text direction, to a specified text range. This function handles block-level styles, distinguishing it from `apply_text_style`, which formats individual characters with attributes like bold or italic. |