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

universal_mcp/applications/google_drive/README.md

@@ -9,60 +9,57 @@ This is automatically generated from OpenAPI schema for the GoogleDriveApp API.
 
 | Tool | Description |
 |------|-------------|
-| `get_drive_info` | Retrieves detailed information about the user's Google Drive storage and account. |
-| `list_files` | Lists and retrieves files from Google Drive with optional filtering, pagination, and sorting. |
-| `create_file_from_text` | Creates a new file in Google Drive with specified text content and returns the file's metadata. |
-| `upload_a_file` | Uploads a file to Google Drive by creating a file metadata entry and uploading the binary content. |
-| `find_folder_id_by_name` | Searches for and retrieves a Google Drive folder's ID using its name. |
-| `create_folder` | Creates a new folder in Google Drive with optional parent folder specification |
-| `get_file` | Retrieves detailed metadata for a specific file using its ID. |
-| `delete_file` | Deletes a specified file from Google Drive and returns a status message. |
-| `list_user_sinstalled_apps` | List user's installed apps |
-| `get_aspecific_app` | Get a specific app |
-| `information_about_user_and_drive` | Information about user and drive |
-| `list_changes_made_to_afile_or_drive` | List changes made to a file or drive |
-| `get_start_page_token` | Gets the starting pageToken for listing future changes |
-| `subscribe_to_changes_for_auser` | Subscribe to changes for a user |
-| `post_stop_channel` | Stop watching resources through a channel |
-| `lists_afile_scomments` | Lists a file's comments |
-| `create_acomment_on_afile` | Create a comment on a file |
-| `get_comment_by_id` | Get comment by ID |
-| `delete_acomment` | Delete a comment |
-| `update_comment` | Update comment |
-| `list_user_sshared_drive` | List user's shared drive |
-| `create_ashared_drive` | Create a shared drive |
-| `get_ashared_drive_smetadata_by_id` | Get a shared drive's metadata by ID |
-| `permanently_delete_ashared_drive` | Permanently delete a shared drive |
-| `update_metadata_for_ashared_drive` | Update metadata for a shared drive |
-| `hide_drive_by_id_post` | Hide a shared drive from the default view |
-| `unhide_drive` | Restore shared drive to default view |
-| `list_user_sfiles` | List user's files |
-| `create_anew_file` | Create a new file |
-| `generate_aset_of_file_ids` | Generate a set of file IDs |
-| `empty_trash_files` | Permanently delete all of the trashed files |
-| `get_file_metadata` | Get a file's metadata. Use to it to get infromation like parents |
-| `delete_file_by_id` | Permanently delete a file without moving it to the trash |
-| `update_file` | Update a file's metadata and/or content |
-| `copy_file_by_id` | Create a copy of a file and apply any requested update |
-| `export_agoogle_workspace_document` | Export a Google Workspace document |
-| `list_the_labels_on_afile` | List the labels on a file |
-| `modify_labels_applied_to_afile` | Modify labels applied to a file |
-| `subscribe_to_changes_to_afile` | Subscribe to changes to a file |
-| `list_file_permissions` | List a file's or shared drive's permissions |
-| `post_file_permission` | Create a permission for a file or shared drive |
-| `get_permission_by_id` | Get permission by ID |
-| `delete_apermission` | Delete a permission |
-| `update_apermission` | Update a permission |
-| `list_acomment_sreplies` | List a comment's replies |
-| `create_areply_to_acomment` | Create a reply to a comment |
-| `get_reply_by_id` | Get reply by ID |
-| `delete_areply` | Delete a reply |
-| `update_areply` | Update a reply |
-| `list_afile_srevisions` | List a file's revisions |
-| `get_aspecific_revision` | Get a specific revision |
-| `permanently_delete_afile_version` | Permanently delete a file version |
-| `update_arevision` | Update a revision |
-| `list_all_members_of_achannel` | List all members of a channel |
-| `fetch_user_email` | Fetch User Email |
-| `grant_google_drive_access` | Grant Google Drive Access |
-| `move_files` | Moves a file from one folder to another by adding a new parent and removing the old parent. |
+| `get_drive_info` | Fetches key user and storage quota information for the authenticated Google Drive account. This streamlined function offers a focused alternative to `get_about_info`, which queries the same endpoint but exposes all available API parameters, providing a simpler way to get essential account details. |
+| `search_files` | Searches for files in Google Drive, allowing for powerful filtering, sorting, and pagination. |
+| `create_text_file` | Creates a file in Google Drive using an in-memory text string. Unlike `upload_file_from_path`, which reads from a local file, this function first creates the file's metadata (name, parent) and then uploads the provided string content, returning the new file's complete metadata upon completion. |
+| `upload_file_from_path` | Uploads a local file to Google Drive by reading its binary content from a path. It creates the file's metadata, uploads the content, and returns the new file's metadata. This differs from `create_text_file` which uses in-memory string content instead of a local file path. |
+| `find_folder_id_by_name` | Searches for a non-trashed folder by its exact name, returning the ID of the first match. As a utility for `create_folder`, it resolves parent names to IDs and returns None if the folder isn't found or an API error occurs, logging the failure internally. |
+| `create_folder` | Creates a new folder in Google Drive, optionally within a parent specified by name or ID. If a parent name is given, it internally resolves it to an ID using the `find_folder_id_by_name` function. Returns the metadata for the newly created folder upon successful creation. |
+| `get_file_details` | Fetches all default metadata for a specific file by its unique ID. This function provides a simple, direct retrieval of a single file's complete attributes, differing from `search_files` which performs broad queries for multiple files based on various criteria. |
+| `trash_file` | Moves a specified file to the trash using its ID. It provides simplified error handling by returning a dictionary with a success or error message, unlike the `permanently_delete_file` function which raises an exception on failure. |
+| `list_installed_apps` | Retrieves a list of the user's installed Google Drive applications. Allows optional filtering by file extensions or MIME types to find apps capable of opening specific file formats, returning a detailed list of matching applications. |
+| `get_app_by_id` | Retrieves detailed information for a single installed Google Drive application using its unique ID. This provides a targeted alternative to `list_installed_apps`, which returns a complete list, allowing for focused data retrieval about a specific application. |
+| `get_about_info` | Retrieves user account and Drive settings from the `/about` endpoint. This generic function provides full parameter control, offering a flexible alternative to the `get_drive_info` method, which requests specific, predefined fields like storage quota and user details. |
+| `list_drive_changes` | Fetches a paginated list of file changes for a user's account or a specific shared drive, using a required page token. Supports various filters to customize the change log, enabling tracking of file activity for synchronization or auditing. |
+| `get_changes_start_token` | Retrieves a starting page token representing the current state of a user's Drive or a shared drive. This token serves as a baseline for subsequent calls to list future file and folder changes, enabling efficient, incremental change tracking. |
+| `watch_drive_changes` | Sets up a push notification channel to monitor changes across a user's Google Drive or a specific shared drive. This allows an external service to receive updates when files are modified, added, or deleted, based on specified filters. |
+| `stop_watching_channel` | Terminates an active push notification channel, ceasing the delivery of updates for a watched Google Drive resource. This requires the channel's ID and resource ID to identify and close the specific notification stream, effectively unsubscribing from real-time changes. |
+| `list_file_comments` | Retrieves a paginated list of all top-level comments for a specified Google Drive file. It supports filtering by modification time and including deleted comments, fetching parent comments rather than replies, unlike `list_comment_replies`. |
+| `create_file_comment` | Creates a new comment on a specified Google Drive file. It requires a file ID and the comment's content, returning the new comment's metadata. This adds top-level comments, distinct from `create_comment_reply` which replies to existing comments. |
+| `get_file_comment_by_id` | Retrieves a single comment's metadata using its unique comment and file IDs. This provides targeted access to one comment, unlike `list_file_comments` which lists all comments for a file. It can optionally include deleted comments in the returned data. |
+| `delete_comment` | Permanently deletes a specific comment from a Google Drive file, identified by both the file and comment IDs. This irreversible action removes the top-level comment and its replies, distinguishing it from the `delete_reply` function which targets only individual replies within a comment thread. |
+| `update_comment` | Updates an existing comment on a specified file using its unique ID. This function allows for partial modification of the comment's properties, such as its content or resolved status, and returns the updated comment's metadata. |
+| `list_shared_drives` | Retrieves a paginated list of shared drives accessible to the user. Supports optional query-based filtering and can be executed with domain administrator privileges to list all shared drives within the domain, returning a dictionary containing the list of drives and pagination details. |
+| `create_shared_drive` | Creates a new shared drive using a unique `requestId` for idempotency. This function allows specifying initial properties such as its name, background image, and access restrictions, returning the created drive's metadata on success. |
+| `get_shared_drive_metadata` | Retrieves metadata for a specific shared drive using its ID. Unlike `get_drive_info`, which gets user account data, this function targets a single drive's properties. It supports domain administrator access and allows specifying fields to customize the response, returning the drive's detailed information. |
+| `delete_shared_drive` | Permanently deletes a shared drive by its ID. This irreversible action removes the entire drive and, unlike `trash_file`, can optionally delete all its contents for domain administrators, providing a complete removal solution for a shared workspace. |
+| `update_shared_drive` | Updates a shared drive's metadata properties, such as its name, theme, or color, using its ID. This function sends a PATCH request to modify the drive and returns a dictionary containing the complete, updated metadata for the shared drive upon success. |
+| `hide_drive` | Hides a specified shared drive from the user's default view using its ID. This function sends a POST request to the API's hide endpoint, returning updated drive metadata. It is the direct counterpart to the `unhide_drive` function, which restores visibility. |
+| `unhide_drive` | Makes a hidden shared drive visible again in the user's default view by its ID. This function sends a POST request to the Google Drive API's `/unhide` endpoint, effectively reversing the action of the `hide_drive` function, and returns the updated drive metadata. |
+| `search_files_advanced` | Exhaustively lists or searches files using advanced parameters for filtering, sorting, and pagination. As a low-level alternative to the simplified `search_files` function, it provides granular control by exposing the full range of Google Drive API query options for complex retrieval. |
+| `create_file_metadata` | Creates a new file's metadata resource in Google Drive, allowing detailed configuration of properties like name, MIME type, and parent folders. Unlike `upload_file_from_path` or `create_text_file`, this function only creates the metadata entry without uploading any file content. |
+| `generate_file_ids` | Generates a batch of unique IDs for future Google Drive files or shortcuts. This utility optimizes creation workflows by allowing identifiers to be fetched in advance, specifying quantity, storage space (e.g., 'drive'), and item type (e.g., 'files'). |
+| `empty_trash` | Permanently deletes all files and folders from the trash. This irreversible action can target the user's main trash or a specific shared drive's trash via its `driveId`, distinguishing it from `trash_file` which only moves a single item to the trash. |
+| `permanently_delete_file` | Permanently deletes a file by its ID, bypassing the trash for irreversible removal. Unlike the simpler `trash_file` function, this method offers advanced control through numerous optional API parameters, such as handling files located in shared drives. |
+| `update_file_metadata` | Modifies a file's metadata properties, such as name, description, or trashed status, using its unique ID. It also moves files by changing parent attributes, acting as a comprehensive alternative to the more specialized `move_file` function. |
+| `copy_file` | Creates a copy of a file using its ID. This function can simultaneously apply metadata updates, such as a new name or parent folder, to the duplicate upon creation and returns the new file's metadata. |
+| `export_file` | Exports a Google Workspace document (e.g., Google Doc) by its ID, converting it to a specified format like PDF using the `mimeType` argument. This function returns the raw, converted file content for download, differentiating it from methods that retrieve metadata. |
+| `list_file_labels` | Retrieves a paginated list of all labels applied to a specific file in Google Drive, identified by its unique ID. It allows controlling the number of results per page and navigating through pages of labels, differing from `modify_file_labels` which alters them. |
+| `modify_file_labels` | Atomically modifies the set of labels on a specified file in Google Drive. It can add, update, or remove labels based on the provided list of modifications, returning the updated label metadata for the file. |
+| `watch_file_for_changes` | Establishes a push notification channel for a specific file, enabling real-time updates via webhook. Unlike `watch_drive_changes`, which monitors an entire drive, this function provides targeted notifications for content or metadata updates to a single file identified by its ID. |
+| `list_file_permissions` | Retrieves the list of permissions for a specified file or shared drive. This function supports pagination and various query parameters to customize results for different access levels, such as domain administration, unlike `get_permission_by_id` which fetches a single permission. |
+| `create_file_permission` | Creates a permission for a file or shared drive, assigning roles like 'reader' to a user, group, or domain. This comprehensive method supports advanced options like notification emails and ownership transfer, distinguishing it from the simplified `create_permission` function which offers fewer parameters. |
+| `get_permission_by_id` | Retrieves metadata for a specific permission on a file or shared drive, identified by its unique ID. This provides targeted access information, unlike `list_file_permissions` which fetches all permissions for a file. |
+| `delete_permission` | Deletes a specific permission from a Google Drive file or shared drive, identified by their respective IDs. This action permanently revokes the access associated with that permission, with optional parameters for shared drives and domain administrator access. |
+| `update_permission` | Updates an existing permission for a file or shared drive using its permission ID. This function can modify a user's role (e.g., from reader to writer), transfer ownership, or change expiration settings, returning the updated permission object upon success. |
+| `list_comment_replies` | Fetches a paginated list of replies for a specific comment, requiring both file and comment IDs. It can optionally include deleted replies. Unlike `list_file_comments`, which retrieves all top-level comments, this function targets replies within a single comment's thread. |
+| `create_comment_reply` | Creates a reply to a specific comment on a Google Drive file. It requires the file ID and the parent comment ID, posting the new reply's content to the correct comment thread. |
+| `get_reply_by_id` | Retrieves a specific reply's metadata from a comment thread using file, comment, and reply IDs. Unlike `list_comment_replies`, which fetches all replies for a comment, this function targets a single one and can optionally include deleted replies in the result. |
+| `delete_reply` | Permanently deletes a specific reply from a comment on a Google Drive file. This targeted operation requires file, comment, and reply IDs to remove a single nested reply, distinguishing it from `delete_comment` which removes an entire top-level comment. |
+| `update_reply` | Updates a specific reply to a comment on a file in Google Drive. It uses file, comment, and reply IDs to locate the reply, allowing modification of its properties like content. The function then returns the updated reply's metadata. |
+| `list_file_revisions` | Retrieves a paginated list of all historical versions (revisions) for a specific file in Google Drive. Supports page size and token parameters to navigate a file's change history, differentiating it from functions that get, update, or delete a single revision. |
+| `get_revision` | Fetches metadata for a single, specific file revision using its file and revision IDs. Unlike `list_file_revisions` which lists a file's complete version history, this function targets one historical version to retrieve its unique metadata. |
+| `delete_file_revision` | Permanently deletes a specific revision of a file, identified by its file and revision IDs. This irreversible action removes a single historical version, distinguishing it from functions like `permanently_delete_file`, which deletes the entire file, or `trash_file`, which moves it to the trash. |
+| `update_revision` | Updates the metadata for a specific file revision using its file and revision IDs. It modifies properties such as pinning the revision (`keepForever`) or its publication status, and returns the updated revision metadata upon success. |
+| `create_permission` | Grants a specified role (e.g., 'reader') to a user or group for a file. This is a simplified alternative to the comprehensive `create_file_permission` function, focusing only on the core arguments required for basic sharing operations and omitting advanced options like notification settings or ownership transfer. |
+| `move_file` | Moves a file to a new folder by updating its parent references. This function adds the file to a destination folder (`add_parents`) and removes it from the source (`remove_parents`), offering a focused alternative to the more comprehensive `update_file_metadata` function. |

universal_mcp/applications/google_drive/app.py

@@ -67,23 +67,35 @@ class GoogleDriveApp(APIApplication):
         return response.json()
 
     def search_files(
-        self, page_size: int = 10, query: str | None = None, order_by: str | None = None
+        self, page_size: int = 10, q: str | None = None, order_by: str | None = None
     ) -> dict[str, Any]:
         """
-        Searches for files in Google Drive, allowing for powerful filtering, sorting, and pagination. This streamlined function offers a more user-friendly alternative to the comprehensive `search_files_advanced` method, making it ideal for targeted queries like finding files by name, type, or parent folder.
-        
+        Searches for files in Google Drive, allowing for powerful filtering, sorting, and pagination.
+        This streamlined function offers a more user-friendly alternative to the comprehensive search_files_advanced method, making it ideal for targeted queries like finding files by name, type, or parent folder.
+
         Args:
             page_size: Maximum number of files to return per page (default: 10)
-            query: Optional search query string using Google Drive query syntax (e.g., "mimeType='image/jpeg'")
-            order_by: Optional field name to sort results by, with optional direction (e.g., "modifiedTime desc")
-        
+            q: Optional search query string using **Google Drive query syntax**.
+                - You must specify a field (e.g., `name`, `fullText`, `mimeType`, `modifiedTime`, `parents`)
+                - Supported operators: `=`, `!=`, `<`, `<=`, `>`, `>=`, `contains`, `in`
+                - Combine conditions with `and` / `or`
+                - String values must be in single quotes `'...'`
+                
+                Examples:
+                    - "mimeType='application/pdf'"
+                    - "name contains 'contract' or name contains 'agreement'"
+                    - "fullText contains 'service' and mimeType!='application/vnd.google-apps.folder'"
+
+            order_by: Optional field name to sort results by, with optional direction
+                - e.g., "modifiedTime desc", "name asc"
+
         Returns:
             Dictionary containing a list of files and metadata, including 'files' array and optional 'nextPageToken' for pagination
-        
+
         Raises:
             HTTPError: Raised when the API request fails or returns an error status code
             RequestException: Raised when network connectivity issues occur during the API request
-        
+
         Tags:
             list, files, search, google-drive, pagination, important
         """
@@ -91,8 +103,8 @@ class GoogleDriveApp(APIApplication):
         params = {
             "pageSize": page_size,
         }
-        if query:
-            params["q"] = query
+        if q:
+            params["q"] = q
         if order_by:
             params["orderBy"] = order_by
         response = self._get(url, params=params)

universal_mcp/applications/google_gemini/README.md

@@ -9,17 +9,6 @@ This is automatically generated from OpenAPI schema for the GoogleGeminiApp API.
 
 | Tool | Description |
 |------|-------------|
-| `fetch_model` | Retrieves the configuration details of current model via a GET request. |
-| `fetch_models` | Retrieves a paginated list of available models, supporting page size and token parameters for result navigation. |
-| `text_only_input` | Generates content using the Gemini 1.5 Flash model via POST request, |
-| `generate_atext_stream` | Generates a streaming response from the Gemini 1.5 Flash model for multimodal input content. |
-| `resumable_upload_request` | Initiates a file upload by sending file metadata. |
-| `prompt_document` | Generates content using the Gemini model with document context. |
-| `text_tokens` | Calculates the number of tokens and billable characters for input content using a gemini-2.0-flash. |
-| `fetch_tuned_models` | Retrieves a list of tuned models at the specified page size using the GET method. |
-| `create_atuned_model` | Creates a tuned model using the "POST" method at the "/v1beta/tunedModels" endpoint and returns a response upon successful creation. |
-| `prompt_the_tuned_model` | Generates content using a specified tuned model defined at path "/v1beta/{tunedModel}:generateContent" by sending a POST request. |
-| `delete_tuned_model` | Deletes a specified tuned model and returns a success status upon removal. |
-| `generate_embeddings` | Generates a text embedding vector from input text using the specified Gemini Embedding model, allowing for semantic analysis and comparison of textual content. |
-| `batch_embeddings` | Generates batch embeddings for a list of text inputs using the "gemini-embedding-exp-03-07" model via a POST request to the "/v1beta/models/text-embedding-004:batchEmbedContents" endpoint. |
-| `discovery_document` | Retrieves discovery metadata for REST APIs, including available endpoints and parameters, based on the specified version. |
+| `generate_text` | Generates text using the Google Gemini model based on a given prompt. |
+| `generate_image` | Generates an image based on a text prompt and an optional reference image using the Google Gemini model. |
+| `generate_audio` | Generates audio from a given text prompt using the Google Gemini model's Text-to-Speech (TTS) capabilities. |

universal_mcp/applications/google_mail/README.md

@@ -9,23 +9,23 @@ This is automatically generated from OpenAPI schema for the GoogleMailApp API.
 
 | Tool | Description |
 |------|-------------|
-| `send_email` | Sends an email using the Gmail API and returns a confirmation or error message. |
-| `create_draft` | Creates a draft email message in Gmail using the Gmail API and returns a confirmation status. |
-| `send_draft` | Sends an existing draft email using the Gmail API and returns a confirmation message. |
-| `get_draft` | Retrieves and formats a specific draft email from Gmail by its ID |
-| `list_drafts` | Retrieves and formats a list of email drafts from the user's Gmail mailbox with optional filtering and pagination. |
-| `get_message` | Retrieves and formats a specific email message from Gmail API by its ID, including sender, recipient, date, subject, and full message body content. |
-| `list_messages` | Retrieves and formats a list of messages from the user's Gmail mailbox with optional filtering and pagination support. |
-| `list_labels` | Retrieves and formats a list of all labels (both system and user-created) from the user's Gmail account, organizing them by type and sorting them alphabetically. |
-| `create_label` | Creates a new Gmail label with specified visibility settings and returns creation status details. |
-| `get_profile` | Retrieves and formats the user's Gmail profile information including email address, message count, thread count, and history ID. |
-| `update_drafts` | Updates an existing Gmail draft with new message content and metadata. |
-| `trash_messsages` | Moves a message to the trash folder (acts like delete functionality). |
-| `untrash_messages` | Moves a message out of the trash, effectively undoing a trash action and restoring the message to the user's mailbox. |
-| `get_attachments` | Retrieves the actual file content of a specific attachment from a Gmail message |
-| `update_labels` | Update an existing Gmail label's properties such as name, color, or visibility. |
-| `delete_labels` | Delete a Gmail label by its ID. |
-| `get_filters` | Fetch Gmail filter configuration and rules by filter ID |
-| `delete_filters` | Remove Gmail filter and its associated automation rules |
-| `list_filters` | Retrieve all Gmail filters and their automation settings |
-| `create_filters` | Set up new Gmail filter with criteria and automated actions |
+| `send_email` | Composes and immediately sends an email message via the Gmail API. It can function as a reply within an existing conversation if a `thread_id` is provided. This action is distinct from `send_draft`, which sends a previously saved draft message, or `create_draft`, which only saves an email. |
+| `create_draft` | Saves a new email draft in Gmail with a specified recipient, subject, and body. An optional thread ID can create the draft as a reply within an existing conversation, distinguishing it from `send_email`, which sends immediately. |
+| `send_draft` | Sends a pre-existing Gmail draft identified by its unique ID. It posts to the `/drafts/send` endpoint, converting a saved draft into a sent message. This function acts on drafts from `create_draft` and differs from `send_email`, which composes and sends an email in one step. |
+| `get_draft` | Retrieves a specific Gmail draft by its unique ID. This function allows specifying the output format (e.g., full, raw) to control the response detail. Unlike `list_drafts`, it fetches a single, known draft rather than a collection of multiple drafts. |
+| `list_drafts` | Fetches a list of email drafts, allowing filtering by a search query and limiting results. It can optionally include drafts from spam and trash, returning a collection of draft objects. This is distinct from `get_draft`, which retrieves only a single, specific draft by its ID. |
+| `get_message_details` | Retrieves a specific email from Gmail by its ID. It parses the API response to extract and format key details—including sender, subject, body, and attachments—into a structured dictionary. This function provides detailed data for a single message, distinguishing it from `list_messages` which fetches multiple messages. |
+| `list_messages` | Fetches a paginated list of detailed email messages using optional search queries. It concurrently retrieves full content (sender, subject, body) for each message, returning the results and a pagination token. This differs from `get_message_details`, which fetches only a single message. |
+| `list_labels` | Fetches a complete list of all available labels from the user's Gmail account via the API. It retrieves both system-defined (e.g., INBOX) and user-created labels, returning their names and IDs, complementing management functions like `create_label` and `update_label`. |
+| `create_label` | Creates a new Gmail label with a specified name, hardcoding its visibility to ensure it appears in both label and message lists. This function complements `update_label` and `delete_label` by adding new organizational tags to the user's account via the API. |
+| `get_profile` | Retrieves the authenticated user's Gmail profile from the API. The profile includes the user's email address, total message and thread counts, and the mailbox's history ID, offering a high-level summary of the account's state. |
+| `update_draft` | Replaces the entire content of a specific Gmail draft, identified by its ID, with a new message object. This allows complete modification of the recipient, subject, and body, serving as the primary "edit" function for drafts created via `create_draft`. |
+| `trash_message` | Moves a specific Gmail message to the trash folder by its unique ID. This action performs a soft delete and is the direct counterpart to `untrash_message`, which restores a message. It requires both a user ID and the specific message ID to make the API call. |
+| `untrash_message` | Restores a specific Gmail message from the trash to the user's mailbox, identified by its unique ID. It serves as the direct counterpart to `trash_message`, undoing the deletion action and making the message visible again in the user's account via an API call. |
+| `get_attachment` | Fetches the raw, base64-encoded content of a specific email attachment using its unique ID. It requires the parent message and user IDs for a targeted API request, returning the file's size and data for download or processing, unlike functions that only list attachment metadata. |
+| `update_label` | Updates an existing Gmail label's properties, such as its name, color, or visibility, using its unique ID. This modification function is distinct from `create_label` and `delete_label`, returning the full, updated label resource from the API upon successful completion. |
+| `delete_label` | Permanently removes a specific Gmail label from a user's account, identified by its unique ID. This function performs an irreversible deletion via an API call, requiring both the `userId` and the label `id`. It is the destructive counterpart to `create_label` and `update_label`. |
+| `get_filter` | Fetches a single Gmail filter's configuration by its unique ID for a specified user. It returns the filter’s criteria (e.g., sender) and actions (e.g., add label). This differs from `get_all_filters`, which retrieves a complete list of all filters for the user. |
+| `delete_filter` | Permanently removes a specific Gmail filter, identified by its unique ID, from a user's account. This action deletes the filter's criteria and all associated automation rules, making it the destructive counterpart to `create_filter` and `get_filter`. |
+| `get_all_filters` | Retrieves all configured email filters for a specified Gmail user ID. It fetches a list of a user's filters, including their matching criteria and automated actions, distinguishing it from `get_filter`, which retrieves only a single filter. |
+| `create_filter` | Creates a new automated email filter in Gmail for a specified user. It requires defining matching criteria (e.g., sender, subject) and an action (e.g., add label). This function adds new rules, distinguishing it from `get_all_filters` and `delete_filter` which manage existing ones. |

universal_mcp/applications/google_searchconsole/README.md

@@ -9,13 +9,13 @@ This is automatically generated from OpenAPI schema for the GoogleSearchconsoleA
 
 | Tool | Description |
 |------|-------------|
-| `get_sitemap` | Retrieves information about a specific sitemap. |
-| `list_sitemaps` | Lists the sitemaps-entries submitted for this site, or included in the sitemap index file  |
-| `submit_sitemap` | Submits a sitemap for a site. Typically returns HTTP 204 No Content on success. |
-| `delete_sitemap` | Deletes a sitemap from this site. Typically returns HTTP 204 No Content on success. |
-| `get_site` | Retrieves information about a specific site. |
-| `list_sites` | Lists the user's Search Console sites. |
-| `add_site` | Adds a site to the set of the user's sites in Search Console. |
-| `delete_site` | Removes a site from the set of the user's Search Console sites. |
-| `index_inspect_url` | Inspects a URL in Google Index and provides information about its status. |
-| `query_search_analytics` | Queries your search traffic data with filters and parameters that you define. |
+| `get_sitemap` | Retrieves detailed information for a single sitemap from a specified Google Search Console property. Unlike `list_sitemaps` which fetches all sitemaps, this function targets one sitemap by its URL (`feedpath`) to return its resource details, including status and last processed date. |
+| `list_sitemaps` | Retrieves a list of sitemaps for a specific site property. It can optionally list sitemaps contained within a specified sitemap index file. This function contrasts with `get_sitemap`, which fetches details for only a single, specified sitemap rather than a collection. |
+| `submit_sitemap` | Submits a sitemap to a specified Google Search Console property using its URL (feedpath). It notifies Google to crawl the sitemap's location, complementing other sitemap management functions (`list_sitemaps`, `delete_sitemap`) by adding or updating a sitemap's registration for a given site. |
+| `delete_sitemap` | Deletes a specific sitemap from a Google Search Console property using its URL (`feedpath`). This function is distinct from `delete_site`, which removes the entire site property, not just a single sitemap file. It issues an HTTP DELETE request to the specified API endpoint. |
+| `get_site` | Retrieves detailed information for a specific site property from Google Search Console using its URL. Unlike `list_sites`, which fetches all properties associated with the user's account, this function targets and returns the resource for a single, known site. |
+| `list_sites` | Retrieves all websites and domain properties the authenticated user manages in Google Search Console. While `get_site` fetches a single, specific property, this function returns a comprehensive list of all sites linked to the user's account, providing a complete overview of managed properties. |
+| `add_site` | Adds a site property to the user's Google Search Console account using its URL. This action requires subsequent ownership verification. Unlike `list_sites`, which only retrieves existing properties, this function creates a new entry and returns the corresponding site resource upon successful creation. |
+| `delete_site` | Removes a website property from the user's Google Search Console account using its URL. Unlike `delete_sitemap`, which only targets a sitemap file, this function deletes the entire site property, revoking management access and removing it from the user's list of managed sites. |
+| `inspect_url` | Retrieves the Google Index status for a specified URL within a given Search Console property. This function queries the URL Inspection API to return detailed information about how Google sees the page, including its indexing eligibility and any detected issues. |
+| `query_search_analytics` | Queries and retrieves search traffic data for a specified site within a given date range. Supports advanced filtering, grouping by various dimensions (e.g., query, page, device), and aggregation to customize the analytics report from the Google Search Console API. |

universal_mcp/applications/google_sheet/README.md

@@ -9,28 +9,28 @@ This is automatically generated from OpenAPI schema for the GoogleSheetApp API.
 
 | Tool | Description |
 |------|-------------|
-| `create_spreadsheet` | Creates a new blank Google Spreadsheet with the specified title and returns the API response. |
-| `get_spreadsheet` | Retrieves detailed information about a specific Google Spreadsheet using its ID  excluding cell data. |
-| `batch_get_values` | Retrieves multiple ranges of values from a Google Spreadsheet in a single batch request. |
-| `insert_dimensions` | Inserts new rows or columns into a Google Sheet at a specific position within the sheet. |
-| `append_dimensions` | Appends empty rows or columns to the end of a Google Sheet. |
-| `delete_dimensions` | Tool to delete specified rows or columns from a sheet in a google spreadsheet. use when you need to remove a range of rows or columns. |
-| `add_sheet` | Adds a new sheet (worksheet) to a spreadsheet. use this tool to create a new tab within an existing google sheet, optionally specifying its title, index, size, and other properties. |
-| `delete_sheet` | Tool to delete a sheet (worksheet) from a spreadsheet. use when you need to remove a specific sheet from a google sheet document. |
-| `add_basic_chart` | Adds a basic chart to a Google Spreadsheet like a column chart, bar chart, line chart and  area chart. |
-| `add_pie_chart` | Adds a pie chart to a Google Spreadsheet. |
-| `add_table` | Adds a table to a Google Spreadsheet. |
-| `update_table` | Updates an existing table in a Google Spreadsheet. |
-| `clear_values` | Clears all values from a specified range in a Google Spreadsheet while preserving cell formatting and other properties |
-| `update_values` | Updates cell values in a specified range of a Google Spreadsheet using the Sheets API |
-| `batch_update` | Updates a specified range in a google sheet with given values, or appends them as new rows if `first cell location` is omitted; ensure the target sheet exists and the spreadsheet contains at least one worksheet. |
-| `clear_basic_filter` | Tool to clear the basic filter from a sheet. use when you need to remove an existing basic filter from a specific sheet within a google spreadsheet. |
-| `list_tables` | This action is used to list all tables in a google spreadsheet, call this action to get the list of tables in a spreadsheet. discover all tables in a google spreadsheet by analyzing sheet structure and detecting data patterns. uses heuristic analysis to find header rows, data boundaries, and table structures. |
-| `get_values` | Retrieves values from a specific range in a Google Spreadsheet. |
-| `get_table_schema` | Analyzes table structure and infers column names, types, and constraints. |
-| `set_basic_filter` | Tool to set a basic filter on a sheet in a google spreadsheet. use when you need to filter or sort data within a specific range on a sheet. |
-| `copy_to_sheet` | Tool to copy a single sheet from a spreadsheet to another spreadsheet. Use when you need to duplicate a sheet into a different spreadsheet. |
-| `append_values` | Tool to append values to a spreadsheet. use when you need to add new data to the end of an existing table in a google sheet. |
-| `batch_clear_values` | Tool to clear one or more ranges of values from a spreadsheet. use when you need to remove data from specific cells or ranges while keeping formatting and other properties intact. |
-| `batch_get_values_by_data_filter` | Tool to return one or more ranges of values from a spreadsheet that match the specified data filters. use when you need to retrieve specific data sets based on filtering criteria rather than entire sheets or fixed ranges. |
-| `format_cells` | Applies comprehensive cell formatting to a specified range in a Google Sheets worksheet. |
+| `create_spreadsheet` | Creates a new, blank Google Spreadsheet file with a specified title. This function generates a completely new document, unlike `add_sheet` which adds a worksheet (tab) to an existing spreadsheet. It returns the API response containing the new spreadsheet's metadata. |
+| `get_spreadsheet_metadata` | Retrieves a spreadsheet's metadata and structural properties, such as sheet names, IDs, and named ranges, using its unique ID. This function intentionally excludes cell data, distinguishing it from `get_values` which fetches the actual content within cells. |
+| `get_values` | Retrieves cell values from a single, specified A1 notation range. Unlike `batch_get_values_by_range` which fetches multiple ranges, this function is for a singular query and provides options to control the data's output format (e.g., rows vs. columns, formatted vs. raw values). |
+| `batch_get_values_by_range` | Efficiently retrieves values from multiple predefined A1 notation ranges in a single API request. Unlike `get_values`, which fetches a single range, or `batch_get_values_by_data_filter`, which uses dynamic filtering criteria, this function operates on a simple list of range strings for bulk data retrieval. |
+| `insert_dimensions` | Inserts a specified number of empty rows or columns at a given index, shifting existing content. Distinct from `append_dimensions`, which only adds to the end, this function creates space within the sheet's data grid, preserving surrounding data and formatting. |
+| `append_dimensions` | Adds a specified number of empty rows or columns to the end of a designated sheet. Unlike `insert_dimensions`, which adds space at a specific index, this function exclusively extends the sheet's boundaries at the bottom or to the right without affecting existing content. |
+| `delete_dimensions` | Deletes a specified range of rows or columns, permanently removing them and shifting subsequent cells. This alters the sheet's structure, unlike `clear_values` which only removes cell content. It is the direct counterpart to `insert_dimensions`, which adds space within the data grid. |
+| `add_sheet` | Adds a new worksheet (tab) to an existing Google Spreadsheet. It allows extensive customization of the new sheet's properties, such as its title, position, and dimensions. This is distinct from `create_spreadsheet`, which generates a completely new spreadsheet file instead of modifying an existing one. |
+| `add_basic_chart` | Adds various axis-based charts (e.g., column, bar, line, area) to a spreadsheet from specified data ranges. The chart can be placed on a new sheet or positioned on an existing one. This is distinct from `add_pie_chart`, which creates proportional visualizations instead of axis-based charts. |
+| `add_pie_chart` | Adds a pie or donut chart to a Google Spreadsheet from a specified data range. Unlike the more general `add_basic_chart`, this is specialized for visualizing data as proportions of a whole and supports pie-specific options like creating a donut chart via the `pie_hole` parameter. |
+| `add_table` | Creates a structured table within a specified range on a Google Sheet. Defines the table's name, ID, and dimensions, and can optionally configure column properties like data types and validation rules. This action creates a formal table object, distinct from functions that only write cell values. |
+| `update_table` | Modifies properties of an existing table within a Google Sheet, such as its name, data range, or column specifications. This function updates the table's structural metadata, distinguishing it from `update_values` which alters the cell data within the table's range. |
+| `clear_values` | Clears data from a single, specified cell range while preserving all formatting. Unlike `delete_dimensions`, it only removes content, not the cells themselves. For clearing multiple ranges simultaneously, use the `batch_clear_values` function. |
+| `update_values` | Overwrites cell values within a specific A1 notation range using a provided 2D list. This function replaces existing data in a predefined area, distinguishing it from `append_values`, which adds new rows after a table instead of overwriting a specific block of cells. |
+| `batch_clear_values` | Clears cell values from multiple specified ranges in a single batch operation, preserving existing formatting. Unlike `clear_values`, which handles a single range, this method efficiently processes a list of ranges at once, removing only the content and not the cells themselves. |
+| `batch_get_values_by_data_filter` | Retrieves values from spreadsheet ranges matching a list of data filters. This method provides dynamic, criteria-based selection using A1 notation or grid coordinates, unlike `batch_get_values_by_range` which uses a simple list of range strings. It is ideal for fetching multiple, specific datasets in one request. |
+| `copy_sheet_to_spreadsheet` | Copies a specific sheet, including all its data and formatting, from a source spreadsheet to a different destination spreadsheet. This action duplicates an entire worksheet into another workbook, returning properties of the newly created sheet. |
+| `write_values_to_sheet` | Writes a 2D list of values to a sheet, overwriting existing data. Data is written starting from a specified cell, or defaults to cell A1 if no location is provided. This differs from `append_values`, which adds new rows after existing data without replacing content. |
+| `append_values` | Appends rows of data after a specified table in a Google Sheet. Distinct from `update_values` which overwrites data, this function adds new rows at the end of the table. It can also insert rows, shifting existing cells down, offering finer control over data addition. |
+| `clear_basic_filter` | Removes the basic filter from a specified sheet, clearing active sorting and filtering criteria to restore the default data view. As the direct counterpart to `set_basic_filter`, this function removes the entire filter object, not just the cell content. |
+| `delete_sheet` | Permanently deletes a specific sheet (worksheet) from a Google Spreadsheet using its sheet ID. This operation removes the target sheet and all its contents, acting as the direct counterpart to the `add_sheet` function which creates new sheets within a spreadsheet. |
+| `discover_tables` | Heuristically analyzes a spreadsheet to discover and list all table-like data structures, identifying headers and data boundaries. It returns informal data blocks meeting specified size criteria, distinguishing it from functions like `add_table` that manage formally defined tables. |
+| `analyze_table_schema` | Infers a specified table's schema by analyzing a data sample. After locating the table by name (a value discovered via `discover_tables`), this function determines the most likely data type and properties for each column, providing a detailed structural breakdown of its content. |
+| `set_basic_filter` | Sets or updates a basic filter on a specified range within a sheet, enabling data sorting and filtering. The filter's target range and optional sort specifications are defined in a dictionary argument. It is the counterpart to `clear_basic_filter`, which removes an existing filter. |
+| `format_cells` | Applies comprehensive formatting to a specified cell range in a worksheet. It modifies visual properties like text style, color, alignment, borders, and can merge cells, without altering the underlying cell values, distinguishing it from data-modification functions like `update_values`. |