bn-google-workspace-mcp-server 0.0.2 → 0.0.5

package/README.md

@@ -1,6 +1,6 @@
 # Google Workspace MCP Server
 
-A comprehensive Model Context Protocol (MCP) server for Google Workspace services including Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, and Chat with OAuth2 authentication.
+A comprehensive Model Context Protocol (MCP) server for Google Workspace services including Gmail, Drive, Calendar, Docs, Sheets, Slides, Contacts, and YouTube with OAuth2 authentication.
 
 ## Features
 
@@ -10,9 +10,8 @@ A comprehensive Model Context Protocol (MCP) server for Google Workspace service
 - **Google Docs**: Document creation and content access
 - **Google Sheets**: Spreadsheet operations, data reading and creation
 - **Google Slides**: Presentation management and creation
-- **Google Forms**: Form creation and management
-- **Google Tasks**: Task list and task management
-- **Google Chat**: Space management and messaging
+- **Google Contacts**: Contact CRUD via People API (list, search, create, update, delete)
+- **YouTube**: Video search, ratings, playlists, subscriptions, and comments via YouTube Data API v3
 - **OAuth2 Authentication**: Secure access via Google Access Tokens
 - **Stateless Architecture**: Each request is independent with Bearer token authentication
 - **TypeScript Implementation**: Built with TypeScript for type safety and maintainability
@@ -64,9 +63,9 @@ Authorization: Bearer ya29.your-google-access-token
 
 ## Tools
 
-The server provides 25 tools for comprehensive Google Workspace API access. Each tool requires `Authorization: Bearer <token>` header.
+The server provides 39 tools across 8 Google services. Each tool requires `Authorization: Bearer <token>` header.
 
-### Gmail Tools
+### Gmail Tools (4)
 
 #### 1. gmail_list_labels
 List all Gmail labels.
@@ -88,7 +87,7 @@ curl -X POST http://localhost:30000/mcp \
 ```
 
 #### 2. gmail_search_messages
-Search Gmail messages.
+Search Gmail messages using Gmail search operators.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -153,10 +152,10 @@ curl -X POST http://localhost:30000/mcp \
   }'
 ```
 
-### Google Drive Tools
+### Google Drive Tools (3)
 
 #### 5. drive_list_files
-List Google Drive files.
+List and search Google Drive files using Drive Query Language.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -221,10 +220,10 @@ curl -X POST http://localhost:30000/mcp \
   }'
 ```
 
-### Google Calendar Tools
+### Google Calendar Tools (3)
 
 #### 8. calendar_list_events
-List Google Calendar events.
+List upcoming Google Calendar events.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -245,7 +244,7 @@ curl -X POST http://localhost:30000/mcp \
 ```
 
 #### 9. calendar_list_calendars
-List Google Calendars.
+List all Google Calendars.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -286,10 +285,10 @@ curl -X POST http://localhost:30000/mcp \
   }'
 ```
 
-### Google Docs Tools
+### Google Docs Tools (2)
 
 #### 11. docs_get_document
-Get Google Docs document.
+Get Google Docs document content.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -331,10 +330,10 @@ curl -X POST http://localhost:30000/mcp \
   }'
 ```
 
-### Google Sheets Tools
+### Google Sheets Tools (3)
 
 #### 13. sheets_get_spreadsheet
-Get Google Sheets spreadsheet.
+Get Google Sheets spreadsheet metadata.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -397,7 +396,7 @@ curl -X POST http://localhost:30000/mcp \
   }'
 ```
 
-### Google Slides Tools
+### Google Slides Tools (2)
 
 #### 16. slides_get_presentation
 Get Google Slides presentation.
@@ -441,10 +440,10 @@ curl -X POST http://localhost:30000/mcp \
   }'
 ```
 
-### Google Tasks Tools
+### Google Contacts Tools (6)
 
-#### 18. tasks_list_task_lists
-List Google Tasks task lists.
+#### 18. contacts_list_contacts
+List all contacts with pagination and sorting.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -453,17 +452,19 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "18",
+    "id": "29",
     "method": "tools/call",
     "params": {
-      "name": "tasks_list_task_lists",
-      "arguments": {}
+      "name": "contacts_list_contacts",
+      "arguments": {
+        "pageSize": 50
+      }
     }
   }'
 ```
 
-#### 19. tasks_list_tasks
-List tasks from a Google Tasks list.
+#### 19. contacts_search_contacts
+Search contacts by name, email, or phone number.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -472,19 +473,19 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "19",
+    "id": "30",
     "method": "tools/call",
     "params": {
-      "name": "tasks_list_tasks",
+      "name": "contacts_search_contacts",
       "arguments": {
-        "taskListId": "@default"
+        "query": "John"
       }
     }
   }'
 ```
 
-#### 20. tasks_create_task
-Create a task in Google Tasks.
+#### 20. contacts_get_contact
+Get a specific contact by resource name.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -493,23 +494,45 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "20",
+    "id": "31",
     "method": "tools/call",
     "params": {
-      "name": "tasks_create_task",
+      "name": "contacts_get_contact",
       "arguments": {
-        "taskListId": "@default",
-        "title": "Complete project documentation",
-        "notes": "Review and finalize all documentation for the project"
+        "resourceName": "people/c1234567890"
       }
     }
   }'
 ```
 
-### Google Forms Tools
+#### 21. contacts_create_contact
+Create a new contact with name, email, phone, organization, and notes.
 
-#### 21. forms_create_form
-Create a Google Form.
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "32",
+    "method": "tools/call",
+    "params": {
+      "name": "contacts_create_contact",
+      "arguments": {
+        "givenName": "Jane",
+        "familyName": "Doe",
+        "email": "jane@example.com",
+        "phone": "+1-555-0100",
+        "organization": "Acme Inc",
+        "jobTitle": "Engineer"
+      }
+    }
+  }'
+```
+
+#### 22. contacts_update_contact
+Update an existing contact (requires etag for optimistic concurrency).
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -518,19 +541,21 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "21",
+    "id": "33",
     "method": "tools/call",
     "params": {
-      "name": "forms_create_form",
+      "name": "contacts_update_contact",
       "arguments": {
-        "title": "Customer Feedback Survey"
+        "resourceName": "people/c1234567890",
+        "etag": "%EgUBAi43...",
+        "jobTitle": "Senior Engineer"
       }
     }
   }'
 ```
 
-#### 22. forms_get_form
-Get Google Form information.
+#### 23. contacts_delete_contact
+Delete a contact.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -539,21 +564,21 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "22",
+    "id": "34",
     "method": "tools/call",
     "params": {
-      "name": "forms_get_form",
+      "name": "contacts_delete_contact",
       "arguments": {
-        "formId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
+        "resourceName": "people/c1234567890"
       }
     }
   }'
 ```
 
-### Google Chat Tools
+### YouTube Tools (16)
 
-#### 23. chat_list_spaces
-List Google Chat spaces.
+#### 24. youtube_search
+Search YouTube for videos, channels, or playlists.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -562,17 +587,321 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "23",
+    "id": "35",
     "method": "tools/call",
     "params": {
-      "name": "chat_list_spaces",
-      "arguments": {}
+      "name": "youtube_search",
+      "arguments": {
+        "query": "MCP tutorial",
+        "type": "video",
+        "maxResults": 5
+      }
+    }
+  }'
+```
+
+#### 25. youtube_get_video_details
+Get detailed information about one or more videos.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "36",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_get_video_details",
+      "arguments": {
+        "videoIds": "dQw4w9WgXcQ"
+      }
+    }
+  }'
+```
+
+#### 26. youtube_get_video_rating
+Check if the authenticated user has liked/disliked a video.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "37",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_get_video_rating",
+      "arguments": {
+        "videoIds": "dQw4w9WgXcQ"
+      }
+    }
+  }'
+```
+
+#### 27. youtube_rate_video
+Like, dislike, or remove rating from a video.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "38",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_rate_video",
+      "arguments": {
+        "videoId": "dQw4w9WgXcQ",
+        "rating": "like"
+      }
+    }
+  }'
+```
+
+#### 28. youtube_get_channel
+Get channel information (own channel or by ID).
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "39",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_get_channel",
+      "arguments": {
+        "mine": true
+      }
+    }
+  }'
+```
+
+#### 29. youtube_list_subscriptions
+List the authenticated user's subscriptions.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "40",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_list_subscriptions",
+      "arguments": {
+        "maxResults": 10
+      }
+    }
+  }'
+```
+
+#### 30. youtube_subscribe_channel
+Subscribe to a YouTube channel.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "41",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_subscribe_channel",
+      "arguments": {
+        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }'
+```
+
+#### 31. youtube_unsubscribe_channel
+Unsubscribe from a YouTube channel (requires subscription ID).
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "42",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_unsubscribe_channel",
+      "arguments": {
+        "subscriptionId": "xxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }'
+```
+
+#### 32. youtube_list_playlists
+List playlists (own or by channel ID).
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "43",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_list_playlists",
+      "arguments": {
+        "mine": true
+      }
+    }
+  }'
+```
+
+#### 33. youtube_create_playlist
+Create a new YouTube playlist.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "44",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_create_playlist",
+      "arguments": {
+        "title": "My Favorites",
+        "description": "A collection of my favorite videos",
+        "privacyStatus": "private"
+      }
+    }
+  }'
+```
+
+#### 34. youtube_list_playlist_items
+List videos in a playlist.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "45",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_list_playlist_items",
+      "arguments": {
+        "playlistId": "PLxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }'
+```
+
+#### 35. youtube_add_to_playlist
+Add a video to a playlist.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "46",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_add_to_playlist",
+      "arguments": {
+        "playlistId": "PLxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "videoId": "dQw4w9WgXcQ"
+      }
+    }
+  }'
+```
+
+#### 36. youtube_remove_from_playlist
+Remove a video from a playlist (requires playlist item ID).
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "47",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_remove_from_playlist",
+      "arguments": {
+        "playlistItemId": "UExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxQ"
+      }
+    }
+  }'
+```
+
+#### 37. youtube_list_comments
+List comments on a YouTube video.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "48",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_list_comments",
+      "arguments": {
+        "videoId": "dQw4w9WgXcQ",
+        "maxResults": 10
+      }
+    }
+  }'
+```
+
+#### 38. youtube_post_comment
+Post a top-level comment on a YouTube video.
+
+```bash
+curl -X POST http://localhost:30000/mcp \
+  -H "Content-Type: application/json" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Authorization: Bearer ya29.your-google-access-token" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": "49",
+    "method": "tools/call",
+    "params": {
+      "name": "youtube_post_comment",
+      "arguments": {
+        "videoId": "dQw4w9WgXcQ",
+        "text": "Great video!"
+      }
     }
   }'
 ```
 
-#### 24. chat_send_message
-Send a message to Google Chat.
+#### 39. youtube_reply_to_comment
+Reply to an existing YouTube comment.
 
 ```bash
 curl -X POST http://localhost:30000/mcp \
@@ -581,13 +910,13 @@ curl -X POST http://localhost:30000/mcp \
   -H "Authorization: Bearer ya29.your-google-access-token" \
   -d '{
     "jsonrpc": "2.0",
-    "id": "24",
+    "id": "50",
     "method": "tools/call",
     "params": {
-      "name": "chat_send_message",
+      "name": "youtube_reply_to_comment",
       "arguments": {
-        "spaceName": "spaces/AAAAxxxxxxx",
-        "text": "Hello from the Google Workspace MCP Server!"
+        "parentId": "UgxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxQ",
+        "text": "Thanks for sharing!"
       }
     }
   }'
@@ -630,15 +959,14 @@ google-workspace/
 │   ├── google-api-client.ts # Google API service factories
 │   └── tools/
 │       ├── index.ts      # Tool exports
-│       ├── gmail.ts      # Gmail tools
-│       ├── drive.ts      # Drive tools
-│       ├── calendar.ts   # Calendar tools
-│       ├── docs.ts       # Docs tools
-│       ├── sheets.ts     # Sheets tools
-│       ├── slides.ts     # Slides tools
-│       ├── tasks.ts      # Tasks tools
-│       ├── forms.ts      # Forms tools
-│       └── chat.ts       # Chat tools
+│       ├── gmail.ts      # Gmail tools (4)
+│       ├── drive.ts      # Drive tools (3)
+│       ├── calendar.ts   # Calendar tools (3)
+│       ├── docs.ts       # Docs tools (2)
+│       ├── sheets.ts     # Sheets tools (3)
+│       ├── slides.ts     # Slides tools (2)
+│       ├── contacts.ts   # Contacts tools (6)
+│       └── youtube.ts    # YouTube tools (16)
 └── dist/                 # Compiled JavaScript
 ```
 
@@ -647,10 +975,10 @@ google-workspace/
 1. **Create Google Cloud Project:**
    - Go to [Google Cloud Console](https://console.cloud.google.com/)
    - Create a new project or select existing
-   - Enable required APIs (Gmail, Drive, Calendar, etc.)
+   - Enable required APIs (Gmail, Drive, Calendar, People, YouTube)
 
 2. **Set up OAuth2:**
-   - Go to "Credentials" → "Create Credentials" → "OAuth 2.0 Client IDs"
+   - Go to "Credentials" -> "Create Credentials" -> "OAuth 2.0 Client IDs"
    - Configure OAuth consent screen
    - Download client configuration
 
@@ -663,9 +991,8 @@ google-workspace/
    https://www.googleapis.com/auth/documents
    https://www.googleapis.com/auth/spreadsheets
    https://www.googleapis.com/auth/presentations
-   https://www.googleapis.com/auth/tasks
-   https://www.googleapis.com/auth/forms.body
-   https://www.googleapis.com/auth/chat.spaces
+   https://www.googleapis.com/auth/contacts
+   https://www.googleapis.com/auth/youtube.force-ssl
    ```
 
 4. **Get Access Token:**

package/dist/google-api-client.d.ts

@@ -32,15 +32,11 @@ export declare function getSheetsService(req: Request): import("googleapis").she
  */
 export declare function getSlidesService(req: Request): import("googleapis").slides_v1.Slides;
 /**
- * Get Google Tasks API service
+ * Get Google People API service (Contacts)
  */
-export declare function getTasksService(req: Request): import("googleapis").tasks_v1.Tasks;
+export declare function getPeopleService(req: Request): import("googleapis").people_v1.People;
 /**
- * Get Google Forms API service
+ * Get YouTube Data API v3 service
  */
-export declare function getFormsService(req: Request): import("googleapis").forms_v1.Forms;
-/**
- * Get Google Chat API service
- */
-export declare function getChatService(req: Request): import("googleapis").chat_v1.Chat;
+export declare function getYouTubeService(req: Request): import("googleapis").youtube_v3.Youtube;
 //# sourceMappingURL=google-api-client.d.ts.map