@coretext-ai/public-gsuite-mcp-d495ced0-92b0-4d0e-ad89-f27c9e31f4f9/README.md

MCP server with full GSuite integrations

# 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

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

## Environment Setup

Create a `.env` file with the following variables:

```env
GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here
```

## Usage

### Running the server

```bash
# Development mode
npm run dev

# Production mode
npm run build && npm start
```

### Using with Claude Desktop

Add this to your Claude Desktop configuration:

```json
{
  "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