universal-mcp-applications 0.1.20__py3-none-any.whl → 0.1.22__py3-none-any.whl

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
 
@@ -55,18 +54,18 @@ class GoogleCalendarApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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
         """
@@ -99,19 +98,19 @@ class GoogleCalendarApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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
         """
@@ -138,7 +137,7 @@ class GoogleCalendarApp(APIApplication):
     ) -> 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_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
         """
@@ -197,7 +196,7 @@ class GoogleCalendarApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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 (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
         """
@@ -288,7 +289,7 @@ class GoogleCalendarApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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
         """
@@ -342,7 +343,7 @@ class GoogleCalendarApp(APIApplication):
     ) -> Any:
         """
         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}
         """
@@ -401,7 +402,7 @@ class GoogleCalendarApp(APIApplication):
     ) -> 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 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
         """
@@ -459,13 +460,13 @@ 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 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
         """
@@ -492,8 +493,8 @@ class GoogleCalendarApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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/app.py

@@ -12,17 +12,17 @@ class GoogleDocsApp(APIApplication):
     def create_document(self, title: str) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             title: The title for the new Google Document to be created
-        
+
         Returns:
             A dictionary containing the Google Docs API response with document details and metadata
-        
+
         Raises:
             HTTPError: If the API request fails due to network issues, authentication errors, or invalid parameters
             RequestException: If there are connection errors or timeout issues during the API request
-        
+
         Tags:
             create, document, api, important, google-docs, http
         """
@@ -35,17 +35,17 @@ class GoogleDocsApp(APIApplication):
     def get_document(self, document_id: str) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the document to retrieve
-        
+
         Returns:
             A dictionary containing the document data from the Google Docs API response
-        
+
         Raises:
             HTTPError: If the API request fails or the document is not found
             JSONDecodeError: If the API response cannot be parsed as JSON
-        
+
         Tags:
             retrieve, read, api, document, google-docs, important
         """
@@ -58,19 +58,19 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             content: The text content to be inserted into the document
             index: The zero-based position in the document where the text should be inserted (default: 1)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the batch update operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             update, insert, document, api, google-docs, batch, content-management, important
         """
@@ -99,7 +99,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             start_index: The zero-based start index of the text range to style
@@ -111,14 +111,14 @@ class GoogleDocsApp(APIApplication):
             link_url: URL to make the text a hyperlink
             foreground_color: RGB color dict with 'red', 'green', 'blue' values (0.0 to 1.0)
             background_color: RGB color dict with 'red', 'green', 'blue' values (0.0 to 1.0)
-        
+
         Returns:
             A dictionary containing the Google Docs API response
-        
+
         Raises:
             HTTPError: When the API request fails
             RequestException: When there are network connectivity issues
-        
+
         Tags:
             style, format, text, document, api, google-docs, simple
         """
@@ -205,7 +205,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             start_index: The zero-based start index of the paragraph range to style
@@ -216,14 +216,14 @@ class GoogleDocsApp(APIApplication):
             spacing_mode: The spacing mode ('NEVER_COLLAPSE', 'COLLAPSE_LISTS')
             segment_id: The segment ID for the range (optional)
             tab_id: The tab ID for the range (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response
-        
+
         Raises:
             HTTPError: When the API request fails
             RequestException: When there are network connectivity issues
-        
+
         Tags:
             style, format, paragraph, document, api, google-docs, batch, content-management
         """
@@ -287,21 +287,21 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             start_index: The zero-based start index of the content range to delete
             end_index: The zero-based end index of the content range to delete (exclusive)
             segment_id: The ID of the header, footer, or footnote segment (optional)
             tab_id: The ID of the tab containing the content to delete (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the delete operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             delete, remove, content, document, api, google-docs, batch, content-management, important
         """
@@ -334,7 +334,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             location_index: The zero-based index where the table should be inserted
@@ -342,14 +342,14 @@ class GoogleDocsApp(APIApplication):
             columns: The number of columns in the table
             segment_id: The ID of the header, footer or footnote segment (optional)
             tab_id: The ID of the tab containing the location (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the insert table operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             table, insert, document, api, google-docs, batch, content-management
         """
@@ -391,21 +391,21 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             footer_type: The type of footer to create (DEFAULT, HEADER_FOOTER_TYPE_UNSPECIFIED)
             section_break_location_index: The index of the SectionBreak location (optional)
             section_break_segment_id: The segment ID of the SectionBreak location (optional)
             section_break_tab_id: The tab ID of the SectionBreak location (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the create footer operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             footer, create, document, api, google-docs, batch, content-management
         """
@@ -443,7 +443,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             location_index: The index where to insert the footnote reference (optional)
@@ -452,14 +452,14 @@ class GoogleDocsApp(APIApplication):
             end_of_segment_location: Whether to insert at end of segment (optional)
             end_of_segment_segment_id: The segment ID for end of segment location (optional)
             end_of_segment_tab_id: The tab ID for end of segment location (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the create footnote operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             footnote, create, document, api, google-docs, batch, content-management
         """
@@ -506,19 +506,19 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             footer_id: The ID of the footer to delete
             tab_id: The tab that contains the footer to delete (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the delete footer operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             footer, delete, remove, document, api, google-docs, batch, content-management
         """
@@ -546,21 +546,21 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             header_type: The type of header to create (DEFAULT, HEADER_FOOTER_TYPE_UNSPECIFIED)
             section_break_location_index: The index of the SectionBreak location (optional)
             section_break_segment_id: The segment ID of the SectionBreak location (optional)
             section_break_tab_id: The tab ID of the SectionBreak location (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the create header operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             header, create, document, api, google-docs, batch, content-management, important
         """
@@ -594,19 +594,19 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             header_id: The ID of the header to delete
             tab_id: The tab containing the header to delete (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the delete header operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             header, delete, remove, document, api, google-docs, batch, content-management
         """
@@ -635,7 +635,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             start_index: The zero-based start index of the range to apply bullets to
@@ -659,14 +659,14 @@ class GoogleDocsApp(APIApplication):
                 - NUMBERED_ZERODECIMAL_ALPHA_ROMAN: ZERODECIMAL, ALPHA and ROMAN with periods
             segment_id: The segment ID for the range (optional)
             tab_id: The tab ID for the range (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the create bullets operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             bullets, list, paragraph, document, api, google-docs, batch, content-management
         """
@@ -705,21 +705,21 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         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`.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated
             start_index: The zero-based start index of the range to remove bullets from
             end_index: The zero-based end index of the range to remove bullets from (exclusive)
             segment_id: The segment ID for the range (optional)
             tab_id: The tab ID for the range (optional)
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the delete bullets operation
-        
+
         Raises:
             HTTPError: When the API request fails, such as invalid document_id or insufficient permissions
             RequestException: When there are network connectivity issues or API endpoint problems
-        
+
         Tags:
             bullets, delete, remove, list, paragraph, document, api, google-docs, batch, content-management
         """