public-gsuite-mcp

MCP server with full GSuite integrations

This MCP server was generated using the Template Orchestrator and includes the following integrations:

Available Tools

This MCP server provides 87 tools across 4 integrations:

GoogleCalendar Tools

• google-calendar_list_calendars: Returns the calendars on the user's calendar list
• google-calendar_get_calendar: Returns metadata for a calendar
• google-calendar_create_calendar: Creates a secondary calendar
• google-calendar_update_calendar: Updates metadata for a calendar
• google-calendar_delete_calendar: Deletes a secondary calendar. Returns 204 No Content with empty body on success.
• google-calendar_list_events: Returns events on the specified calendar
• google-calendar_get_event: Returns an event
• google-calendar_create_event: Creates an event
• google-calendar_update_event: Updates an event
• google-calendar_delete_event: Deletes an event. Returns 204 No Content with empty body on success.
• google-calendar_quick_add: Creates an event based on a simple text string
• google-calendar_get_free_busy: Returns free/busy information for a set of calendars
• google-calendar_list_acl: Returns the rules in the access control list for the calendar
• google-calendar_create_acl: Creates an access control rule

GoogleContacts Tools

• google-contacts_create_contact: Create a new contact with specified fields
• google-contacts_get_person: Get a specific contact by resource name
• google-contacts_update_contact: Update an existing contact. IMPORTANT: Include the 'etag' field in the request body to prevent conflicts. Get the current etag by first calling get_contact or from a previous create/update response.
• google-contacts_delete_contact: Delete a contact permanently
• google-contacts_list_connections: List authenticated user's contacts
• google-contacts_search_contacts: Search across all contacts with text query
• google-contacts_batch_get_people: Get multiple contacts by resource names
• google-contacts_list_contact_groups: List all contact groups
• google-contacts_create_contact_group: Create a new contact group
• google-contacts_get_contact_group: Get a specific contact group by resource name
• google-contacts_update_contact_group: Update an existing contact group. IMPORTANT: Include the 'etag' field in the contactGroup object to prevent conflicts. Get the current etag by first calling get_contact_group or from a previous create/update response.
• google-contacts_delete_contact_group: Delete a contact group
• google-contacts_modify_contact_group_members: Add or remove members from a contact group
• google-contacts_list_directory_people: List people in the authenticated user's domain directory (G Suite/Workspace). TROUBLESHOOTING: If returns empty results, verify: 1) User is part of Google Workspace domain, 2) Directory access is enabled, 3) User has sufficient privileges (may need domain admin), 4) OAuth scopes include directory.readonly
• google-contacts_search_directory_people: Search people in the authenticated user's domain directory. TROUBLESHOOTING: If returns empty results, verify: 1) User is part of Google Workspace domain, 2) Directory access is enabled, 3) User has sufficient privileges (may need domain admin), 4) OAuth scopes include directory.readonly
• google-contacts_list_other_contacts: List other contacts (auto-created contacts from interactions)
• google-contacts_search_other_contacts: Search other contacts with text query
• google-contacts_copy_other_contact: Copy an other contact to the authenticated user's contacts

GoogleDrive Tools

• google-drive_upload_file_simple: Simple upload for files ≤5MB. Upload file content directly. NOTE: Simple uploads provide limited metadata control - use multipart upload for custom names/folders.
• google-drive_upload_file_multipart: Multipart upload for files with metadata. Combines metadata and content in single request with full metadata control.
• google-drive_upload_file_resumable: Initiate resumable upload for large files with progress tracking
• google-drive_get_file: Get file metadata by ID
• google-drive_download_file: Download file content or export Google Workspace documents
• google-drive_export_file: Export Google Workspace document to specified format
• google-drive_update_file: Update file metadata
• google-drive_update_file_content: Update file content using multipart upload
• google-drive_delete_file: Permanently delete a file. Returns 204 No Content with empty body on success.
• google-drive_copy_file: Create a copy of an existing file
• google-drive_create_folder: Create a new folder
• google-drive_move_file: Move a file to different parent folders
• google-drive_get_folder_contents: List files and folders within a specific folder
• google-drive_get_folder_tree: Get folder hierarchy and structure
• google-drive_list_files: List files in Google Drive with optional search query and filtering
• google-drive_search_files: Advanced file search with complex query syntax
• google-drive_list_file_revisions: List revisions of a specific file
• google-drive_get_file_revision: Get a specific revision of a file
• google-drive_update_file_revision: Update revision metadata (e.g., set keepForever)
• google-drive_delete_file_revision: Delete a specific revision of a file. Returns 204 No Content with empty body on success.
• google-drive_create_permission: Create a permission for a file or folder (sharing)
• google-drive_list_permissions: List permissions for a file or folder
• google-drive_get_permission: Get a specific permission for a file
• google-drive_update_permission: Update an existing permission
• google-drive_delete_permission: Remove a permission from a file or folder. Returns 204 No Content with empty body on success.
• google-drive_create_comment: Create a comment on a file
• google-drive_list_comments: List comments on a file
• google-drive_get_comment: Get a specific comment
• google-drive_update_comment: Update a comment
• google-drive_delete_comment: Delete a comment. Returns 204 No Content with empty body on success.

GoogleGmail Tools

• google-gmail_send_message: Send an email message. Requires message in RFC 2822 format encoded as base64url string
• google-gmail_get_message: Get a specific message by ID
• google-gmail_list_messages: List messages in user's mailbox with optional filtering
• google-gmail_modify_message: Modify labels on a message (add/remove labels, mark read/unread)
• google-gmail_trash_message: Move a message to trash (RECOMMENDED for deleting emails). This is the standard way users delete emails - messages remain recoverable for 30 days.
• google-gmail_untrash_message: Remove a message from trash
• google-gmail_delete_message: PERMANENTLY delete a message - IMMEDIATE and IRREVERSIBLE. WARNING: Use trash_message instead for normal email deletion. Only use this for sensitive data that must be immediately destroyed. Bypasses trash completely. REQUIRES https://mail.google.com/ scope. Returns 204 No Content with empty body on success.
• google-gmail_list_labels: List all labels in the user's mailbox
• google-gmail_get_label: Get label details by ID
• google-gmail_create_label: Create a new custom label
• google-gmail_update_label: Update an existing label
• google-gmail_delete_label: Delete a custom label. Returns 204 No Content with empty body on success.
• google-gmail_list_threads: List email threads in user's mailbox
• google-gmail_get_thread: Get a specific thread by ID
• google-gmail_modify_thread: Modify labels on all messages in a thread
• google-gmail_trash_thread: Move an entire email thread/conversation to trash (RECOMMENDED for deleting conversations). This is the standard way users delete email threads - remains recoverable for 30 days.
• google-gmail_untrash_thread: Remove a thread from trash
• google-gmail_delete_thread: PERMANENTLY delete an entire thread - IMMEDIATE and IRREVERSIBLE. WARNING: Use trash_thread instead for normal conversation deletion. Only use this for sensitive data that must be immediately destroyed. Bypasses trash completely. REQUIRES https://mail.google.com/ scope. Returns 204 No Content with empty body on success.
• google-gmail_list_drafts: List draft messages in user's mailbox
• google-gmail_get_draft: Get a specific draft by ID
• google-gmail_create_draft: Create a new draft message. IMPORTANT: Message must be an object with 'raw' field containing base64url-encoded RFC 2822 formatted message.
• google-gmail_update_draft: Update an existing draft. IMPORTANT: Message must be an object with 'raw' field containing base64url-encoded RFC 2822 formatted message.
• google-gmail_send_draft: Send an existing draft
• google-gmail_delete_draft: Delete a draft. Returns 204 No Content with empty body on success.
• google-gmail_get_profile: Get user's Gmail profile information

Installation

npm install @coretext-ai/public-gsuite-mcp-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9

Environment Setup

Create a .env file with the following variables:

GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here

Usage

Running the server

# Development mode
npm run dev

# Production mode
npm run build && npm start

Using with Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "public-gsuite-mcp": {
      "command": "npx",
      "args": ["@coretext-ai/public-gsuite-mcp-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here"
      }
    }
  }
}

Instructions for Fetching API Keys/Tokens

• COMING SOON

Generated Information

• Generated at: Thu Aug 07 2025 03:53:50 GMT+0000 (Coordinated Universal Time)
• Orchestrator version: 0.0.2
• Template repository: Coretext-AI-Dev/server-template-v2
• Total endpoints: 87