@coretext-ai/qa-gsuite-f47ac10b-58cc-4372-a567-0e02b2c3d479/README.md

MCP server with GSuite (Contacts, Drive, Gmail, Calendar) integration

# gsuite-mcp-server

MCP server with GSuite (Contacts, Drive, Gmail, Calendar) integration

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:

### 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
- **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
- **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)
- **google-contacts_search_directory_people**: Search people in the authenticated user's domain directory
- **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
- **google-drive_upload_file_multipart**: Multipart upload for files with metadata. Combines metadata and content in single request
- **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
- **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
- **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
- **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
### 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
- **google-gmail_untrash_message**: Remove a message from trash
- **google-gmail_delete_message**: Permanently delete a message
- **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
- **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 a thread to trash
- **google-gmail_untrash_thread**: Remove a thread from trash
- **google-gmail_delete_thread**: Permanently delete a thread
- **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
- **google-gmail_update_draft**: Update an existing draft
- **google-gmail_send_draft**: Send an existing draft
- **google-gmail_delete_draft**: Delete a draft
- **google-gmail_get_profile**: Get user's Gmail profile information
### 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
- **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
- **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

## Installation

```bash
npm install @coretext-ai/qa-gsuite-f47ac10b-58cc-4372-a567-0e02b2c3d479
```

## Environment Setup

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

```env
GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here
GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here
GOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here
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": {
    "gsuite-mcp-server": {
      "command": "npx",
      "args": ["@coretext-ai/qa-gsuite-f47ac10b-58cc-4372-a567-0e02b2c3d479"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here",
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here",
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here",
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here"
      }
    }
  }
}
```

## Instructions for Fetching API Keys/Tokens
- **COMING SOON**

## Generated Information

- **Generated at**: Thu Jul 24 2025 17:16:33 GMT+0000 (Coordinated Universal Time)
- **Orchestrator version**: 0.0.2
- **Template repository**: Coretext-AI-Dev/server-template-v2
- **Total endpoints**: 87